Reference
Implementation
Look up syntax, contracts, layouts, algorithms, and exact behavior.
The compressor implementation is structured as a reference codec plus predictor backends. The dependency-free toy-byte backend is useful for tests and deterministic examples, while the LZP byte backend provides fast full-file runs. Additional modes cover trained byte models, neural byte predictors, Hugging Face causal language models, and native acceleration through a C extension.
The implementation also includes a local web workbench. It can manage corpora, run compression jobs, inspect archive metadata, train byte or neural sidecar models, and regenerate benchmark reports. AIXC is therefore a laboratory for testing predictor contracts rather than a single codec script.
- aixc/: codec, predictors, entropy coding, CLI, UI server, and native C source.
- tests/: round-trip integrity, varint, bit packing, and backend contract tests.
- benchmarks/: repeatable benchmark scripts and generated report artifacts.
- compression-research-report.md: design notes, model recommendations, and file-format rationale.