Skip to main content

minigraf (Python)

Python binding for Minigraf — zero-config, single-file, embedded bi-temporal graph database with Datalog queries.

Installation

pip install minigraf

Supports Python 3.9+ on Linux (x86_64, aarch64), macOS (universal2), and Windows (x86_64).

Quick start

import json
from minigraf import MiniGrafDb

# In-memory database
db = MiniGrafDb.open_in_memory()
db.execute('(transact [[:alice :name "Alice"] [:alice :age 30]])')

result = json.loads(db.execute("(query [:find ?n ?a :where [?e :name ?n] [?e :age ?a]])"))
print(result["results"])  # [["Alice", 30]]

# File-backed (persisted to disk)
db = MiniGrafDb.open("path/to/mydb.graph")
db.execute('(transact [[:bob :name "Bob"]])')
db.checkpoint()

Building from source

Requires Rust stable toolchain and maturin.

pip install maturin
maturin develop

Cascade release

This repo receives a core-release repository_dispatch from the minigraf monorepo cascade whenever a new version of the minigraf core crate is published. The release workflow pins the new version, commits, tags, builds wheels for all platforms, and publishes to PyPI.

License

MIT OR Apache-2.0

Release files for minigraf 2.0.1

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

Built distributions (wheels)

Table of built distributions (wheels) for minigraf 2.0.1
File
minigraf-2.0.1-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
minigraf-2.0.1-py3-none-manylinux_2_34_x86_64.whl Python 3 none Linux glibc 2.34+ x86-64 Details
minigraf-2.0.1-py3-none-manylinux_2_34_aarch64.whl Python 3 none Linux glibc 2.34+ ARM64 Details
minigraf-2.0.1-py3-none-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl Python 3 none macOS 10.12+ x86-64, macOS 10.12+ universal2 (ARM64, x86-64), macOS 11.0+ ARM64 Details

Total release size: 4.8 MB

Release files / minigraf-2.0.1-py3-none-win_amd64.whl

Download URL minigraf-2.0.1-py3-none-win_amd64.whl
Size 873.8 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
f8f801bc238503845a66cac9bd7294b6b7c0b8a67839b80775d0b641245908ec
BLAKE2b-256 checksum
How to use checksums
0f8e7386b48bbdce9c8bbe17f04b98acd5d6627bab29d041705a92b8b837bf44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release files / minigraf-2.0.1-py3-none-manylinux_2_34_x86_64.whl

Download URL minigraf-2.0.1-py3-none-manylinux_2_34_x86_64.whl
Size 1.0 MB
Tags Linux glibc 2.34+ x86-64 Python 3
SHA-256 checksum
How to use checksums
3cedc9f3ae2251ffb8daff2f6323f27e481230d3f4bcd4c997b8921c75f261a2
BLAKE2b-256 checksum
How to use checksums
a120b9d13cd5e96fa934333860ca04a4933909ddb40c841bb43aa2dcba2424b9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release files / minigraf-2.0.1-py3-none-manylinux_2_34_aarch64.whl

Download URL minigraf-2.0.1-py3-none-manylinux_2_34_aarch64.whl
Size 1.0 MB
Tags Linux glibc 2.34+ ARM64 Python 3
SHA-256 checksum
How to use checksums
2703840994edaa9463fa2c0205dae6a952fae321d37f4eb75591002d1586bfde
BLAKE2b-256 checksum
How to use checksums
07390a885f0771ab0a9e7fbfeb317dd17f4b6adf4b2c67773f7ccaa62f383435
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release files / minigraf-2.0.1-py3-none-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl

Download URL minigraf-2.0.1-py3-none-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Size 1.9 MB
Tags Python 3 macOS 10.12+ universal2 (ARM64, x86-64) macOS 10.12+ x86-64 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
3f254155355ed44a1d7946476c38670664310a8558385b31c70f4668ff370938
BLAKE2b-256 checksum
How to use checksums
febd4c51c9f218805c5dd2d7e3d0f86cba494cc6ed875db37a6ee7d2ed9a913c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.0.1 This release

4 release files

2.0.0

4 release files

1.2.3

4 release files

1.2.2

4 release files

1.2.1

4 release files

1.2.0

4 release files

1.1.1

4 release files

1.1.0

4 release files

1.0.0

4 release files

0.25.0

4 release files

0.24.0

4 release files

0.23.0

4 release files

0.22.0

4 release files

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