Isard Labs
Technical documentation · Level 2 — Architecture
Per platform: stack, module shape, data flow, what makes it distinctive, and how mature it is. Then how six independent codebases coordinate without ever importing one another’s source.
Figures describe engineering footprint, not investment performance.
Architecture at a glance
Four trust boundaries hold it together: no RPC and no source imports (coupling is files, git and published wheels), validated bundles are frozen (machine-built, never hand-edited), signals can’t skip the gate (a new primitive must be requested and implemented, not smuggled in), and no manufacturer certifies itself (a local ladder run is preflight, and preflight is not green).
Lifecycle data flow
| Step | Actor | Writes to AGORA |
|---|---|---|
| 1 · propose | HEURESIS | candidates/<batch>/*.yaml |
| 1b · pre-register | AUTOMATA | journal/ — a frozen, hashed experiment record before any data is read |
| 2 · validate | EPISTEME | results/<batch>/*.scorecard.json |
| 3 · promote | HEURESIS | bundles/<strategy>/ (git-committed) |
| opt · time | KAIROS | regimes/<taxonomy>/*.parquet — only if a strategy gates on it |
| 4 · execute | PRAXIS | journal/YYYY-MM.jsonl (fills) |
Every row is append-only or content-addressed. The journal threads them together, so any fill can be walked back to the search that produced it.
01 / 06 · platform
εὕρεσις — “discovery”
The idea engine · discovery at rate
HEURESIS · role & stack
Grid mode enumerates a parameter space deterministically, cheapest-first, from a frozen YAML campaign config whose hash is recorded — same config, same candidate sequence. Pre-registered batch screens are the current working mode: a named hypothesis, its controls and its acceptance predicate are registered and hashed before the run, with the tool path and code commit stamped into the output artifact.
An LLM-driven proposal mode exists in the tree and is not currently in service — see maturity.
HEURESIS · architecture & differentiators
epi CLI and reads and writes AGORA files; the source tree contains no sibling imports and a gate keeps count.HEURESIS · maturity
It runs pre-registered discovery “marathons” with cost gates, positive and negative controls and significance testing. It is judged on rate and discipline, not hit-rate.
An autonomous, agent-driven campaign mode was built, run for eight weeks, and switched off. Across roughly 1,600 machine-proposed candidates it produced no graduations, and the failure concentrated in a single rung — cost sensitivity — consistently across four different local models and every context size tried. The infrastructure was kept; the operational mode was closed, and the negative result written up rather than quietly left running.
02 / 06 · platform
αὐτόματα — “self-acting”
The experiment layer · provenance
AUTOMATA · role & stack
HEURESIS is judged on rate of disciplined candidates. AUTOMATA is judged on whether a conclusion can be walked back to the run, the spec, the snapshot and the code that produced it — and on whether the search burden behind it is stated honestly. Both submit to the same gate. Neither can certify itself. Running them side by side is the point: it makes the comparison measurable instead of arguable.
It imports canonical metrics from EPISTEME’s published wheels rather than reimplementing them, asks KAIROS for regime distinctions rather than building regime models, and hands execution to PRAXIS. What it builds is the layer none of them owned.
AUTOMATA · architecture & differentiators
AUTOMATA · maturity
Its bar separates gates from disclosures: a gate blocks, a disclosure reports and is never allowed to harden into a gate by rhetoric. It publishes its own incompleteness — of 61 formal done-criteria, ten are declared not built rather than quietly omitted. And a run of the bar is itself recorded, so a check that has never executed renders as unknown, not as green.
03 / 06 · platform
ἐπιστήμη — “demonstrable knowledge”
The gate · the only certifier
EPISTEME · role & stack
The largest and most important platform, and the only thing in the ecosystem permitted to certify. A spec climbs eleven canonical rungs — data quality, causality, costs, signal selection, walk-forward validation, significance, path risk, generalization, adversarial stress, Monte Carlo and deployment readiness — plus default-on sub-rungs covering attribution, cross-engine accounting parity, regime provenance and per-regime metrics, which bring a default green run to sixteen scored records. Further sub-rungs for microstructure and live-forward certification remain opt-in. On green, it emits an executable bundle.
EPISTEME · architecture
EPISTEME · differentiators
EPISTEME · maturity
Driven by dozens of consumer-feedback cycles. Multi-asset support is shipped, not aspirational — cost presets and calendars for spot and perpetual crypto, equities, ETFs, indices, FX, commodities, futures and prediction markets, with point-in-time universe reconstruction, corporate actions and macro release calendars. The certified corpus itself is still entirely crypto; the machinery to move beyond it is already in place.
04 / 06 · platform
καιρός — “the opportune moment”
The regime factory · and the ecosystem’s instruments
optional · a strategy uses it, or doesn’tKAIROS · an elective capability
KAIROS builds the classifiers and validates them on its own ladder, then lends the blessed labels to whoever wants them — a research factory with an independent line, not a service desk. A sibling may also submit its own classifier behind a documented protocol; that path is supported and, so far, rarely taken. The skip is literal: a spec that declares no regime inputs never runs the regime rung at all.
KAIROS · architecture & differentiators
KAIROS · maturity
It built a second, stricter ladder specifically to audit its own gate — pre-registered at a named commit before the code existed — after proving the original could be climbed by a model that ignores its inputs. It then re-scored every prior result against the stricter bar rather than keeping the flattering ones, and under 2% survived, against its own pre-registered prediction of under 15%.
It also ships classifiers designed to fail, permanently, as controls — a validator that never rejects anything is not a validator.
05 / 06 · platform
πρᾶξις — “putting into practice”
The executor · disciplined runtime
PRAXIS · role & stack
PRAXIS loads validated bundles, re-verifies them, and runs them. Strategies are loaded as self-contained modules — PRAXIS holds no signal logic of its own; it is the disciplined runtime around someone else’s proven edge. Reaching real capital is an explicit operator action; today it runs on paper and exchange sandbox.
PRAXIS · architecture & differentiators
PRAXIS · the capital gate
PRAXIS · maturity
Containerised, with runbooks for deploy, promote, halt, reconcile and key rotation, and a real operator product on top — a FastAPI service and a React dashboard per strategy, covering fidelity, capital ramp, kill switch, execution quality and stress tests.
The core runtime has never routed an order to a production exchange endpoint. Nine books run today: eight simulated, one on a venue sandbox with virtual funds. Of nineteen enforced gates, several point at the running fleet rather than the source tree — every deployed book must be running, or declare why not.
Scope: separate PRAXIS-branded deployments trade small prop-firm accounts and are outside this document. No client or fund capital is deployed in any of them.06 / 06 · platform
ἀγορά — “the public marketplace”
The commons · coordination
AGORA · role & surfaces
AGORA · architecture & differentiators
AGORA · maturity
A standing audit panel runs numeric-claim verification and unjustified-bypass detection, and is the busiest correspondent on the bus. Its numeric-claim verifier exists because a cycle-close report once quoted two different totals for the same thing — so the commons now re-derives asserted numbers from source rather than trusting the typing.
Two static gates hunt vacuous controls by name: every tool must have a test that defines a real assertion, verified by parsing the test rather than its filename; and every lint or type suppression must carry an expiry date, enforced strictly in CI.
How they coordinate
| Surface | Producer | Consumer |
|---|---|---|
| schema/ | EPISTEME | HEURESIS · KAIROS · PRAXIS · AUTOMATA |
| artifacts/ | EPISTEME | all siblings — canonical metrics as hash-pinned wheels |
| candidates/ · results/ | HEURESIS · AUTOMATA · EPISTEME | each other (ephemeral) |
| bundles/ | EPISTEME | PRAXIS |
| regime_requests/ | HEURESIS · AUTOMATA | KAIROS (optional) |
| regimes/ | KAIROS | EPISTEME · PRAXIS (opt-in) |
| signal_requests/ | HEURESIS | EPISTEME |
| docs/handoffs/ | all six | all six — schema-linted packets |
| journal/ | all six | operators · audit |
No row in this table is a function call. Every one is a file in a git history.
Plain-language glossary
Evidence, not assertion
Every example above is the safety net doing its job — and the last one is the safety net catching itself.
Why the architecture is the moat
Go deeper
L3 · Deep → names the methods — the rungs, the circuit breaker, the signal families, the governance — for reviewers who want to push on every claim.
Confidential — not for distribution. · Figures describe engineering footprint, not investment performance.