AIXC / docsProject documentation

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.