Configuration

FalkorDB Configuration

Configure FalkorDB as the graph provider for Graphiti

FalkorDB configuration requires version 1.1.2 or higher.

Docker Installation

The simplest way to run FalkorDB is via Docker:

$docker run -p 6379:6379 -p 3000:3000 -it --rm falkordb/falkordb:latest

This command:

  • Exposes FalkorDB on port 6379 (Redis protocol)
  • Provides a web interface on port 3000
  • Runs in foreground mode for easy testing

Configuration

Set the following environment variables for FalkorDB (optional):

$export FALKORDB_HOST=localhost          # Default: localhost
>export FALKORDB_PORT=6379              # Default: 6379
>export FALKORDB_USERNAME=              # Optional: usually not required
>export FALKORDB_PASSWORD=              # Optional: usually not required

Connection in Python

1from graphiti_core import Graphiti
2from graphiti_core.driver.falkordb_driver import FalkorDriver
3
4# FalkorDB connection using FalkorDriver
5falkor_driver = FalkorDriver(
6    host='localhost',        # or os.environ.get('FALKORDB_HOST', 'localhost')
7    port='6379',            # or os.environ.get('FALKORDB_PORT', '6379')
8    username=None,          # or os.environ.get('FALKORDB_USERNAME', None)
9    password=None           # or os.environ.get('FALKORDB_PASSWORD', None)
10)
11
12graphiti = Graphiti(graph_driver=falkor_driver)

FalkorDB uses a dedicated FalkorDriver and connects via Redis protocol on port 6379. Unlike Neo4j, authentication is typically not required for local FalkorDB instances.