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 five independent codebases coordinate without ever importing one another.
Figures describe engineering footprint, not investment performance.
Architecture at a glance
Three trust boundaries hold it together: no RPC or imports (coupling is files + git), validated bundles are frozen (machine-built, never hand-edited), and signals can’t skip the gate (a new primitive must be requested and implemented, not smuggled in).
Lifecycle data flow
| Step | Actor | Writes to AGORA |
|---|---|---|
| 1 · propose | HEURESIS | candidates/<batch>/*.yaml |
| 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 / 05 · platform
εὕρεσις — “discovery”
The idea engine · discovery
HEURESIS · role & stack
Grid mode enumerates a parameter space deterministically, cheapest-first. Hypothesis mode prompts an LLM for novel candidates, then validates its output through a strict schema. A YAML template sends both down a deterministic path before anything leaves the building.
HEURESIS · architecture & differentiators
epi CLI and reads/writes AGORA files — discovery and validation stay fully decoupled.HEURESIS · maturity
--strict + ruff enforced on every changeActively developed — recent work adds an autonomous, agent-driven campaign mode that drives multi-round discovery and digests the validator’s feedback.
02 / 05 · platform
ἐπιστήμη — “demonstrable knowledge”
The gate · validation
EPISTEME · role & stack
The largest and most important platform. A spec climbs rungs spanning data quality, causality, costs, signal selection, walk-forward validation, significance, path risk, generalization, adversarial stress, Monte Carlo and deployment readiness. On green, it emits an executable bundle.
EPISTEME · architecture
EPISTEME · differentiators
EPISTEME · maturity
Driven by dozens of consumer-feedback release cycles — the platform is in continuous, disciplined evolution.
03 / 05 · platform
καιρός — “the opportune moment”
The timing gate · regime validation
optional · a strategy uses it, or doesn’tKAIROS · an elective capability
HEURESIS authors the classifier; KAIROS validates it (“Path B”). A strategy then references a blessed stream — or none at all.
KAIROS · architecture & differentiators
KAIROS · maturity
Correctness is held not only by coverage but by a matrix of known-good and known-bad fixtures: every rung must return the expected verdict on every fixture, byte-for-byte.
04 / 05 · platform
πρᾶξις — “putting into practice”
The executor · live trading
PRAXIS · role & stack
PRAXIS loads validated bundles, re-verifies them, and runs them live. 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.
PRAXIS · architecture & differentiators
PRAXIS · maturity
Ships containerised with documented runbooks for deploy, promote, halt, reconcile and key rotation — operations are first-class, not an afterthought.
05 / 05 · platform
ἀγορά — “the public marketplace”
The commons · coordination
AGORA · role & surfaces
AGORA · architecture & differentiators
AGORA · maturity
CI runs scheduled safety cycles and disaster-recovery drills — the commons polices its own integrity, not just its code.
How they coordinate
| Surface | Producer | Consumer |
|---|---|---|
| schema/ | EPISTEME | HEURESIS · KAIROS |
| candidates/ · results/ | HEURESIS · EPISTEME | each other (ephemeral) |
| bundles/ | EPISTEME | PRAXIS |
| regime_requests/ | HEURESIS | KAIROS (optional) |
| regimes/ | KAIROS | EPISTEME · PRAXIS (opt-in) |
| signal_requests/ | HEURESIS | EPISTEME |
| journal/ | all four | operators · audit |
No row in this table is a function call. Every one is a file in a git history.
Plain-language glossary
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.