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 1.2.3

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 1.2.3
File
minigraf-1.2.3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
minigraf-1.2.3-py3-none-manylinux_2_34_x86_64.whl Python 3 none Linux glibc 2.34+ x86-64 Details
minigraf-1.2.3-py3-none-manylinux_2_34_aarch64.whl Python 3 none Linux glibc 2.34+ ARM64 Details
minigraf-1.2.3-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.7 MB

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

Download URL minigraf-1.2.3-py3-none-win_amd64.whl
Size 861.8 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
3d100a1009b5cd40aed7f7f51343bfcfd1cb6cb0ad11606a5b44f5fbf3a39266
BLAKE2b-256 checksum
How to use checksums
f75151d07436bb17f1b4741a268bb0144f7af8b56ef3da90442b78d5e1821b68
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 Aug 10, 2026.

Transparency log

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

Download URL minigraf-1.2.3-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
1769f7812cab4289501d38866fc6eb66cdfcd7a3827a0f84a0f3d288e01cdf60
BLAKE2b-256 checksum
How to use checksums
2379cb7a542309051738b4a46832eff37088bd0230d9f2944455077c8fa745e1
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 Aug 10, 2026.

Transparency log

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

Download URL minigraf-1.2.3-py3-none-manylinux_2_34_aarch64.whl
Size 997.6 kB
Tags Linux glibc 2.34+ ARM64 Python 3
SHA-256 checksum
How to use checksums
f19fe62f0f281c35fce5dcf184c17ef324375fa1b74abaebcee6d33d8055bb12
BLAKE2b-256 checksum
How to use checksums
a4be568daecbf8722348744f7ff0f2f99a4a24226b522fef1b59f5cfe0004320
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 Aug 10, 2026.

Transparency log

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

Download URL minigraf-1.2.3-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
c122319cee13592f3c25a5264db8a2a650c88d2a52ce0411bd8fd9da7904b436
BLAKE2b-256 checksum
How to use checksums
f8f424cc3e198d054eea86a5276dc9e1d6686f7bedf09c790d14cfef18f987cc
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 Aug 10, 2026.

Transparency log

Release history Release notifications | RSS feed

2.0.1

4 release files

2.0.0

4 release files

This release

1.2.3 This release

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