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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.