Skip to content

Clarify Neo4j vs FalkorDB troubleshooting in quickstart README #1589

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mastroke wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Clarify Neo4j vs FalkorDB troubleshooting in quickstart README #1589

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
870ae64
Clarify Neo4j vs FalkorDB troubleshooting in quickstart README.
mastroke Jun 16, 2026
db7540a
Retrigger CI after CLA signature.
mastroke Jun 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 11 additions & 2 deletions examples/quickstart/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -90,9 +90,9 @@ After running this example, you can:

## Troubleshooting

### "Graph not found: default_db" Error
### Neo4j: "Graph not found: default_db" Error

If you encounter the error `Neo.ClientError.Database.DatabaseNotFound: Graph not found: default_db`, this occurs when the driver is trying to connect to a database that doesn't exist.
If you encounter the error `Neo.ClientError.Database.DatabaseNotFound: Graph not found: default_db` while running **`quickstart_neo4j.py`**, the Neo4j driver is trying to connect to a database that does not exist.

**Solution:**
The Neo4j driver defaults to using `neo4j` as the database name. If you need to use a different database, modify the driver constructor in the script:
Expand All @@ -105,6 +105,15 @@ driver = Neo4jDriver(uri=neo4j_uri, user=neo4j_user, password=neo4j_password)
driver = Neo4jDriver(uri=neo4j_uri, user=neo4j_user, password=neo4j_password, database="your_db_name")
```

### FalkorDB: connection refused or wrong script

If you are using FalkorDB but see Neo4j-specific errors (for example `Neo.ClientError`), you are likely running **`quickstart_neo4j.py`** instead of **`quickstart_falkordb.py`**.

**Solution:**
1. Start a FalkorDB server locally (see [FalkorDB docs](https://docs.falkordb.com/)).
2. Confirm `FALKORDB_URI` points at your instance (default: `falkor://localhost:6379`).
3. Run `python quickstart_falkordb.py`.

## Understanding the Output

### Edge Search Results
Expand Down
Loading