---
id: falkordb
version: "1.7.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# FalkorDB — Python client for interacting with FalkorDB database

License: permissive · Maintenance: active · Downloads: 781.1K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 781.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

graph database client python, cypher query python, falkordb python client, graph db async python, property graph database, graph query language, redis graph client, graph-database, cypher-query, async-support

[View on SkillFed](https://skillfed.io/packages/falkordb) · [View on PyPI](https://pypi.org/project/falkordb/)