AIXC / docsProject documentation

Explanation

Project context and scope

Understand the design decisions, alternatives, and limits.

  1. 01Shared context
  2. 02Predict
  3. 03Hit / miss
  4. 04Decision + residual
  5. 05Exact reconstruction
AIXC at a glance. Follow the responsibilities across the system; use the reference pages for precise contracts.

A reference codec for storing predictor hits, miss residuals, manifests, and integrity metadata around a shared next-unit model.

AIXC explores a simple compression question: if encoder and decoder share the same deterministic predictor, how much of the original text needs to be stored? The current reference implementation stores a seed, packs hit/miss decisions from a predictor, and records residual literals only when prediction fails. The repository includes a binary container, deterministic byte backends, optional Hugging Face model-token experiments, rank residual modes, entropy-coded sections, CRC/SHA integrity checks, a CLI, tests, benchmarks, and a local workbench. This paper summarizes the codec contract, the economics of the reference format, the binary container, and the engineering constraints that matter for reproducible decoding.