Design¶

Architecture and design documents for theseus internals.

Documents¶

• Experiment DAG and Storage — node identities, ticking, branches, Parquet records, and ClickHouse queries.
• Available Chips — all supported chip string keys, memory, and theoretical compute peaks.
• Sharding Design — execution policy, logical tensor axes, and parameter layouts.
• Config System — how field(), build(), and configuration() turn annotated dataclasses into a unified OmegaConf schema.
• Analysis and Plotting — checkpoint inspection, trainer-backed analyses, and figure artifacts logged to Comet.
• Dataloader I/O — latency-aware file reads, replay invariants, and measured storage behavior.