FalkorDB

What it is and what it does

FalkorDB is a Python client library for interacting with FalkorDB, a graph database that uses Cypher as its query language. It provides both synchronous and asynchronous APIs for executing graph queries, managing nodes and relationships, and performing graph operations like copying and deletion. The client connects to a FalkorDB instance (typically running in Docker or via FalkorDB Cloud) through redis as its underlying transport.

The package is built on top of python-dateutil and redis, handling the protocol communication and result parsing. It supports modern Python versions (3.10 through 3.14) and both CPython and PyPy implementations. The asynchronous interface uses asyncio and redis.asyncio for concurrent query execution, making it suitable for applications that need to run multiple graph operations in parallel.

Use it for:

• Build social network applications with friend connections, followers, and relationship queries
• Execute concurrent graph queries in async applications without blocking the event loop
• Perform graph analytics and pattern matching on connected data structures
• Copy and manage multiple graph instances for testing or multi-tenant scenarios
• Query property graphs with typed nodes and relationships using Cypher syntax

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

FalkorDB Python client for querying and managing graph databases using Cypher queries, with support for both synchronous and asynchronous operations.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. It's the official Python client for FalkorDB and suitable for production use. The main prerequisite is having a FalkorDB instance running separately, which is documented in the package description.

Install

falkordb on PyPI

pip install falkordb

uv add falkordb

poetry add falkordb

Installing FalkorDB

Before you install

Low install friction with a pure Python wheel distribution. Actively maintained with a release from 2026-08-13 and no known vulnerabilities. Requires redis as a runtime dependency, which must be running separately.

License in practice

Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install FalkorDB

from falkordb import FalkorDB

db = FalkorDB(host="localhost", port=6379)
g = db.select_graph("social")
result = g.query("MATCH (n) RETURN n LIMIT 10")
for node in result.result_set:
    print(node)

Requires a running FalkorDB instance (typically via Docker or FalkorDB Cloud) accessible at the specified host and port; redis dependency must be installed and running.

Verify before relying

• Performance characteristics and query execution time for large graphs
• Memory overhead and scalability limits for different graph sizes
• Specific Cypher dialect version and feature support coverage

Package facts

Evidence: falkordb-1.7.1-py3-none-any.whl

Keywords: Cypher, FalkorDB, GraphDB

Tags

More Database packages