Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.0rc8

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.0rc8
File Size Uploaded Provenance Actions
graphforge-0.6.0rc8.tar.gz 7.6 MB Without provenance Details for graphforge-0.6.0rc8.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for graphforge 0.6.0rc8
File Interpreter ABI Platform Actions
graphforge-0.6.0rc8-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for graphforge-0.6.0rc8-cp310-abi3-win_amd64.whl
graphforge-0.6.0rc8-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.0rc8-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
graphforge-0.6.0rc8-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for graphforge-0.6.0rc8-cp310-abi3-macosx_11_0_arm64.whl

Total release size: 212.1 MB

Release files / graphforge-0.6.0rc8.tar.gz

Download URL graphforge-0.6.0rc8.tar.gz
Size 7.6 MB
Tags Source
SHA-256 checksum
How to use checksums
db19558d09249bc30841e72ec79f0cd404389aebf1af3def8e8521aa2ab30211
BLAKE2b-256 checksum
How to use checksums
f8b596f115cd21cc4eaef7e3766b9ab8134af1901c8f23d22cec6dc3f4424e06
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.0rc8-cp310-abi3-win_amd64.whl

Download URL graphforge-0.6.0rc8-cp310-abi3-win_amd64.whl
Size 64.3 MB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
0124791d8c64860b43005b19b854b242e1ef89dff3023764b87c817bc7db9a6c
BLAKE2b-256 checksum
How to use checksums
c66bf87835aa9ec5424efa9ec213756aa367cb5dc3e006d2d8bbdb18a24205e7
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.0rc8-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL graphforge-0.6.0rc8-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 74.4 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
e8485a954eaba2d7b08e591043ba585be916a4ae0bc3273e22d6340d38fe7a1d
BLAKE2b-256 checksum
How to use checksums
2de9109ba30849f9b3cc4ff80f323a6de4c936a3e5abab2e94ae8b6023cd65e0
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.0rc8-cp310-abi3-macosx_11_0_arm64.whl

Download URL graphforge-0.6.0rc8-cp310-abi3-macosx_11_0_arm64.whl
Size 65.8 MB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
1211291dac804c38ccac2e4cea62c27fd6671312626a7341d4dd698107a53375
BLAKE2b-256 checksum
How to use checksums
31c620c35ec2222c8afaf99aca32007f45b60cece7e5b13a8eb3c214f80977c9
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.0rc8

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