Skip to content

antikythera-spectral

Hyperdimensional-computing encoder + Pyodide bridge for the Antikythera mechanism.

Status: v0.3.0 on PyPI (antikythera-spectral). Active development. v0.3.0 lands the mars_models facade (bronze projection + Freeth-reconstruction param sets, ADR 0012) and the bit_alu facade (bit-packed binary HDC ALU; the new package default, with backend="complex128" available as v0.2.x opt-out). See CHANGELOG.md for per-version detail and ../ANTIKYTHERA_SPECTRAL_PYPI_PLAN_v0.1.0.md for the original v0.1.0 release plan.

Subtree layout

Path What it is
python/ The PyPI package source — pip install antikythera-spectral builds from here
python/README.md PyPI long-description (the page on pypi.org/project/antikythera-spectral/)
codegen/ Codegen scripts that emit _data/*.json and basis-vector NPZs from ../research/*.py
bridge/ Standalone bridges that aren't part of the wheel (e.g. URL → ephemeris-kernel downloader)
docs/ Bridge API contract, ADRs, ΔT discussion, calendar systems reference
ROADMAP.md Status of advertised CLI / bridge methods
CHANGELOG.md Per-version change log

How this relates to ../research/

docs/antikythera-maths/research/ is the working research scaffold: 25 Python modules totalling ~6 200 LOC that encode the HDC framing of the Antikythera mechanism. It is the single source of truth for cycles, gears, eclipse anchors, period relations, the H-battery, and the architectural-mode hypotheses.

antikythera-spectral is the packaging of that scaffold — it re-exports the encoder/decoder/data via a Pyodide-friendly Bridge API, ships frozen JSON snapshots of the research-scaffold data, and wraps everything in a PyPI distribution so a web frontend can install it via micropip and drive a digital Antikythera in-browser.

The codegen layer (codegen/) keeps the two in sync: every _data/*.json file is regenerable from the research/*.py source, and test_data_freshness.py fails the build if drift exists.

See also