Skip to navigation

FalkorDB Configuration

Configure FalkorDB as the graph provider for Graphiti

FalkorDB configuration requires version 1.1.2 or higher.

Installation

Install Graphiti with FalkorDB support:

pip install graphiti-core[falkordb]

or

uv add graphiti-core[falkordb]

Docker Installation

To run FalkorDB locally, use 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

If your application reads the connection configuration from environment variables, set these values:

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

import os
from graphiti_core import Graphiti
from graphiti_core.driver.falkordb_driver import FalkorDriver
falkor_driver = FalkorDriver(
host=os.environ.get("FALKORDB_HOST", "localhost"),
port=int(os.environ.get("FALKORDB_PORT", "6379")),
username=os.environ.get("FALKORDB_USERNAME"),
password=os.environ.get("FALKORDB_PASSWORD"),
)
graphiti = 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.