Skip to main content

GraphForge for Python

Native Python bindings for GraphForge — an embedded openCypher graph engine with Rust-owned behavior, Arrow results, and a thin repository lifecycle CLI.

External decision results

Provider-neutral results use the public graphforge.DecisionBatchV1 TypedDict contract. Pass one to GraphForge.validate_decision_batch(); Rust validates correlation and values and returns a pyarrow.Table using decision_result/1. Producer execution, thresholds, review and actions stay in caller code. See the decision workflow guide.

Install

pip

pip install graphforge

uv (recommended)

uv add graphforge

First use

from graphforge import GraphForge

forge = GraphForge()  # in-memory; pass a directory path for persistence

alice = forge.add_node("Person", name="Alice", age=30)
bob = forge.add_node("Person", name="Bob", age=25)
forge.add_edge(alice, "KNOWS", bob, since=2020)

table = forge.execute("""
    MATCH (p:Person)-[:KNOWS]->(friend:Person)
    WHERE p.age > 25
    RETURN p.name AS person, friend.name AS friend
""")
print(table.to_pandas())

execute() returns an Apache Arrow Table. The gf and graphforge console commands use inherited stdio and show device notices immediately. Run gf auth login, then gf push or gf publish. Publishing tokens are for CI; captured Python Hub calls still require explicit tokens.

Documentation

Algorithm definitions

rank() supports fixed PageRank iterations and damping, and directed clustering_normalization="neighbor_edges". cluster() supports deterministic synchronous_iterations with an optional Int64 initial_label_property. Existing calls retain their defaults. See the API reference in the full documentation for definitions and invocation descriptors.

Typed Hub workflow

graphforge.HubProject provides typed clone, commit, tag, push/publish, pull and history through the Rust CLI. Captured push/publish calls never prompt: pass public=True or private=True. See the Python facade reference for native errors, Arrow reads and Hub prerequisites.

Metadata

Release files for graphforge 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for graphforge 0.6.0
File Size Uploaded Provenance Actions
graphforge-0.6.0.tar.gz 7.6 MB Without provenance Details for graphforge-0.6.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for graphforge 0.6.0
File Interpreter ABI Platform Actions
graphforge-0.6.0-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for graphforge-0.6.0-cp310-abi3-win_amd64.whl
graphforge-0.6.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.10 abi3 Linux glibc 2.17+ x86-64 Details for graphforge-0.6.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
graphforge-0.6.0-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for graphforge-0.6.0-cp310-abi3-macosx_11_0_arm64.whl

Total release size: 213.2 MB

Release files / graphforge-0.6.0.tar.gz

Download URL graphforge-0.6.0.tar.gz
Size 7.6 MB
Tags Source
SHA-256 checksum
How to use checksums
1fe5f3069f9ca9abd49f7cddfcb3d70a9e2437a5f6ee9a5a838dab5fd74600d6
BLAKE2b-256 checksum
How to use checksums
8601e9daa98cf4a8c49c974ab3b42f691b746a6d7205af9bac9838cc8b245605
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / graphforge-0.6.0-cp310-abi3-win_amd64.whl

Download URL graphforge-0.6.0-cp310-abi3-win_amd64.whl
Size 64.7 MB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
20b0c1b199f5aedde45852b183359165f8143ea569e3c816533becbcaaf83514
BLAKE2b-256 checksum
How to use checksums
7422d09928ab86a060dda6c3ace745622bab440e7a06b678e8cd1b75f864e093
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / graphforge-0.6.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL graphforge-0.6.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 74.8 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
d8b9231f99e6577287c16960eb074c9610b772cd5366993d5e6dd7057e52ceff
BLAKE2b-256 checksum
How to use checksums
2f950f49124d6870f465b707f17541a018bf32215748abcf4897dfc7265635ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / graphforge-0.6.0-cp310-abi3-macosx_11_0_arm64.whl

Download URL graphforge-0.6.0-cp310-abi3-macosx_11_0_arm64.whl
Size 66.1 MB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
3443b9ac5c255b714d8617a6ec7f8f632185dc24641b78345e6aa0ce4f5eec6d
BLAKE2b-256 checksum
How to use checksums
9539098a211e30c47ad5b706b5be214613d324d5371ca393065dc5cf04d4f287
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for graphforge 0.6.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page