---
id: py2neo
version: "2021.2.4"
license: Apache License, Version 2.0
license_treatment: permissive
maintenance: dormant
---

# py2neo — Python client library and toolkit for Neo4j

License: permissive · Maintenance: dormant · Downloads: 85.6K/mo

## What it is and what it does

Py2neo is a Python client library for working with Neo4j graph databases. It provides both Bolt and HTTP protocol support, a high-level query API, an object-graph mapper (OGM), admin tools, and a Cypher lexer for syntax highlighting via Pygments. The library handles connection routing for Neo4j clusters and supports authentication.

However, the project is explicitly end-of-life. The maintainers have announced no further updates and recommend using official Neo4j drivers instead. While the package remains installable and functional for existing deployments, it receives no bug fixes, security patches, or feature development.

Use it for:

- Running Cypher queries against a Neo4j database from Python code with a simple high-level API.
- Building object-graph mappings to work with Neo4j data as Python objects via the OGM layer.
- Connecting to Neo4j clusters with automatic routing support using neo4j:// URIs.
- Prototyping or maintaining legacy Python applications that already depend on py2neo.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Py2neo is a Python client library for Neo4j that provides Bolt and HTTP connectivity, a high-level API, an OGM, and Cypher tooling—though the project is now end-of-life with no further updates planned.

No—not for new projects. The package is end-of-life with no further updates, and the maintainers explicitly recommend official Neo4j drivers instead. For existing codebases already using py2neo, it remains functional but will not receive security patches or bug fixes. Use official Neo4j drivers for any new development.

## Install

pip install py2neo
uv add py2neo
poetry add py2neo

## Installing py2neo

Before you install: Installation is straightforward with low friction; however, the project is explicitly marked end-of-life with no further updates. The last commit was 2023-11-30, and the maintainers recommend using official Neo4j drivers instead. The repository remains unarchived but dormant.

License in practice: Licensed under Apache License, Version 2.0 (permissive), which allows commercial and private use with minimal restrictions—no licensing barrier to adoption.

Quickstart:

pip install py2neo

from py2neo import Graph
graph = Graph("bolt://localhost:7687", auth=("neo4j", "password"))
result = graph.run("UNWIND range(1, 3) AS n RETURN n, n * n as n_sq")

Requires a running Neo4j instance accessible at the specified URI; development and testing are documented for Linux with standard CPython distributions.

Verify before relying:

- Current compatibility with Neo4j versions released after 2023-11-30.
- Whether the eight runtime dependencies remain compatible with modern Python and Neo4j versions.
- Stability and security posture of the package given its end-of-life status and lack of active maintenance.

## Package facts

- License: Apache License, Version 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 85.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

neo4j python client, graph database python driver, cypher query python, neo4j bolt http connector, python graph orm, neo4j toolkit python, graph database client library, end-of-life, graph-database, legacy

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