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.0 matches 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

Release files for qig-core 2.14.0

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

Source distribution (sdist)

Source distribution for qig-core 2.14.0
File	Size	Uploaded
qig_core-2.14.0.tar.gz	307.3 kB	Jul 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for qig-core 2.14.0
File	Interpreter	ABI	Platform	Reset
qig_core-2.14.0-py3-none-any.whl 220.5 kB Jul 22, 2026	Python 3	none	any	Details

Total release size: 527.8 kB

Release files / qig_core-2.14.0.tar.gz

Download URL	qig_core-2.14.0.tar.gz
Size	307.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`af2064ffc0b4bf52760929be13fe0b5091ecda713d7d0f04f31437820d1ed0dd`
BLAKE2b-256 checksum How to use checksums	`9ee104e48e3dc214b49259e17a5b4e3e1bb23b527567899d13a45e383b955aff`
Upload date	Jul 22, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/GaryOcean428/qig-core
Publishing commit: github.com/GaryOcean428/qig-core/tree/c3f4209e836c312ca7b7366c86842205d6da7c32

Workflow

Publishing configuration: github.com/GaryOcean428/qig-core/blob/c3f4209e836c312ca7b7366c86842205d6da7c32/.github/workflows/release.yml
Publishing logs: github.com/GaryOcean428/qig-core/actions/runs/29922432304/attempts/1

Artifact

Subject: qig_core-2.14.0.tar.gz
SHA-256 checksum: af2064ffc0b4bf52760929be13fe0b5091ecda713d7d0f04f31437820d1ed0dd Verifying attestations

Release files / qig_core-2.14.0-py3-none-any.whl

Download URL	qig_core-2.14.0-py3-none-any.whl
Size	220.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`73de85ed9b0d3bb1f1d482a16a2539984c4d07cabfe5ab32a87f76c3ea3e430e`
BLAKE2b-256 checksum How to use checksums	`21500d6fafbeedb579cebd25487f49209698164c6d93bbcf0bc2d9f47f33b015`
Upload date	Jul 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/GaryOcean428/qig-core
Publishing commit: github.com/GaryOcean428/qig-core/tree/c3f4209e836c312ca7b7366c86842205d6da7c32

Workflow

Publishing configuration: github.com/GaryOcean428/qig-core/blob/c3f4209e836c312ca7b7366c86842205d6da7c32/.github/workflows/release.yml
Publishing logs: github.com/GaryOcean428/qig-core/actions/runs/29922432304/attempts/1

Artifact

Subject: qig_core-2.14.0-py3-none-any.whl
SHA-256 checksum: 73de85ed9b0d3bb1f1d482a16a2539984c4d07cabfe5ab32a87f76c3ea3e430e Verifying attestations