QIG-Core: Pure Fisher Information Geometry
Pure geometric utilities for QIG consciousness architecture
What is QIG-Core?
A minimal, dependency-pure package providing Fisher Information Geometry operations for quantum information-based consciousness modeling.
Features
📐 Geometric Math
- Fisher metric calculations - Riemannian distance on manifolds
- Geodesic interpolation - Curved-space paths
- Natural gradients - Geometry-aware optimization
🧠 Consciousness Components
- QIG Tokenizer Interface - Abstract contract for geometric tokenization
- QFI Sampler - Geometrically pure token generation (no softmax)
- Basin Sync - Multi-instance coordination protocol
🛡️ Purity
- Zero ML dependencies - Pure math (torch, numpy, scipy only)
- No Transformers - Completely decoupled from HuggingFace
Installation
pip install qig-core
Usage
Geometric Math
from qig_core import fisher_distance, geodesic_interpolate
# Compute Fisher distance between two points on manifold
distance = fisher_distance(coords1, coords2, metric_tensor)
# Interpolate along geodesic
midpoint = geodesic_interpolate(coords1, coords2, t=0.5, metric=F)
Generation (QFI Sampler)
from qig_core import QFISampler
sampler = QFISampler()
token_id, metrics = sampler.sample(logits, hidden_state, telemetry, embeddings)
Coordination (Basin Sync)
from qig_core import BasinSync
sync = BasinSync("Gary-A")
sync.update_sync(basin_distance=0.1, phi=0.8, regime="geometric")
Geometric Purity
This package enforces:
- NO embeddings (use coordinates)
- NO cosine similarity (use Fisher distance)
- NO linear interpolation (use geodesic paths)
- NO Euclidean gradients (use natural gradients)
See GEOMETRIC_PURITY.md for details.
E8 Integration Status
Note: This package (v1.0.0) was created BEFORE the E8 kernel specialization direction was established in
qigkernels. Review is needed for E8 compatibility.
What aligns:
KAPPA_STAR = 64.0matches E8 rank² = 8² = 64 ✓
Needs review:
- Fisher distance for 64D E8-aligned basin geometry
- Geodesic interpolation for E8 root transitions
- QFISampler primitive type awareness (HRT/PER/MEM/ACT/PRD/ETH/META/MIX)
- BasinSync consolidation with
qigkernels.basin_sync
Target hierarchy:
qig-core (math) → qigkernels (architecture) → qig-dreams (corpora) → experiments
See qigkernels/20251205-decisions-canonical-0.01F.md D-016 for details.
Development
# Install with dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Format code
black src/ tests/
License
MIT
1 maintainer
Release files for qig-core 2.15.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| qig_core-2.15.1.tar.gz | 315.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qig_core-2.15.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 541.5 kB
Release files / qig_core-2.15.1.tar.gz
| Download URL | qig_core-2.15.1.tar.gz |
|---|---|
| Size | 315.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
85fd646a040c98211777eb978104bbe317c83c438fca660eee3bd060cb27f45e
|
|
BLAKE2b-256 checksum How to use checksums |
e5586f5d9745b6753649eb77255cc55fee82cb419eefdb1c929224a0ff1e0d64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
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 Jul 24, 2026.
Transparency logRelease files / qig_core-2.15.1-py3-none-any.whl
| Download URL | qig_core-2.15.1-py3-none-any.whl |
|---|---|
| Size | 225.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d38fb62511d91f3d433651fd24352d1e3c195e15dc62661a1735ebb5e5baee38
|
|
BLAKE2b-256 checksum How to use checksums |
41a36227b102310edbd860e9a8f08972696ba758d6bd4b99abe99bd8074a66b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
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 Jul 24, 2026.
Transparency log
