gini-core
The shared foundation of GINI: the topology model and the tamper-evident proof format. Pure Python, no Qt, no container runtime.
You do not normally install this yourself — gini-toolkit (the gBuilder desktop app) and
gini-teaching-center (the course server) both depend on it.
pip install gini-core
Why it is its own package
The Teaching Center runs on a headless VM and must verify student submissions. Verification needs the proof format; it does not need a GUI. Without this split, installing the course server would drag ~400MB of PySide6 onto a server that never draws a pixel — so the server install is 2.3MB instead.
The second reason matters more. gBuilder writes proofs and the Teaching Center verifies them. Those two implementations must agree exactly, forever — a hash chain that disagrees by one field is a student's work rejected. Keeping the format in one distribution both sides depend on means there is no second copy to drift.
What is in it
gini/domain/
topology.py Topology, DeviceInstance, Link — the model gBuilder saves and loads
devices.py the device/element registry (networking + cloud)
proof.py the hash chain, ticket codes, and receipts
persistence.py the on-disk .gini project format
gini.domain.proof is the interesting one. A proof is an append-only chain in which every
entry commits to the one before it, so a recorded session cannot be edited after the fact without
breaking the chain. It is bound to the activity code it was recorded under, and its submit entry
carries a SHA-256 of the topology — which is what makes a stolen project file worthless: the file
and the code are cryptographically the same claim.
The receipt a student reads off the screen is 40 bits of the chain's MAC, rendered as
XXXX-XXXX. gBuilder and the server derive it identically from the proof itself, so a receipt
handed to an instructor before the upload lands is still the right receipt after it does.
Namespace package
gini is an implicit namespace package shared with gini-toolkit: this distribution owns
gini.domain, the app owns gini.ui, gini.services and the rest. Neither ships a
gini/__init__.py — adding one to either would shadow the other and break the import.
License & links
Part of the GINI project — https://github.com/citelab/gini
1 maintainer
Metadata
1 maintainer
Release files for gini-core 6.20.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 | |
|---|---|---|---|
| gini_core-6.20.0.tar.gz | 353.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gini_core-6.20.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 756.8 kB
Release files / gini_core-6.20.0.tar.gz
| Download URL | gini_core-6.20.0.tar.gz |
|---|---|
| Size | 353.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
65a29e803efc271f26a89fe75db66cd7639d633c1ce218d46d7f41af5c956da3
|
|
BLAKE2b-256 checksum How to use checksums |
dd2afcd66d4681aa4487e5fd5b6fa7f49625cd007656a1c6b0098d741e98a3fc
|
| 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 Oct 17, 2026.
Transparency logRelease files / gini_core-6.20.0-py3-none-any.whl
| Download URL | gini_core-6.20.0-py3-none-any.whl |
|---|---|
| Size | 402.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b05258ab69a97ca06d0cc350cd8ea50ef2fb4b09751ba40eabe5142ea0231e44
|
|
BLAKE2b-256 checksum How to use checksums |
7126e38c0765b499b1bac5a4d5825796c5d3a64953674f1da7800f7e9f7c477e
|
| 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 Oct 17, 2026.
Transparency log
