# bootloops-ai/bootloops architecture

> Architecture diagram of the GitHub repository bootloops-ai/bootloops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bootloops-ai/bootloops
- Repository: https://github.com/bootloops-ai/bootloops

## Overview

BootLoops is a scientific-computing toolkit and verification harness for agent-driven precision quantitative work. The documented workflow is: an agent consults the tool index, proposes instruments and a plan for approval, runs the chosen tools, then checks results against acceptance criteria and independent evidence. The graph preserves major scientific and verification capabilities, but the README does not describe most package-to-package calls; those internal links are therefore omitted. Package paths identify the relevant source areas, not a claim that unsampled code was inspected.

Main entry points: [`tools`](https://github.com/bootloops-ai/bootloops/tree/main/tools) (Scientific tools), [`tools/README.md`](https://github.com/bootloops-ai/bootloops/blob/main/tools/README.md) (Tool index), [`tools/ellipticus`](https://github.com/bootloops-ai/bootloops/tree/main/tools/ellipticus) (Integral engines), [`tools/tropical-sampler/cegm_gj/x36_engine.py`](https://github.com/bootloops-ai/bootloops/blob/main/tools/tropical-sampler/cegm_gj/x36_engine.py) (Grassmannian integrals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Agent workflow"]
  node_tool_index["Tool index<br/>[README.md]"]
  node_plan["Approved plan"]
  node_scientific_tools["Scientific tools"]
end

subgraph group_math["Scientific computation"]
  node_integration["Integral engines"]
  node_grassmannian["Grassmannian integrals<br/>[x36_engine.py]"]
  node_recurrences["Recurrence search<br/>[search.py]"]
  node_symbolic["Symbolic methods"]
end

subgraph group_domains["Domain toolkits"]
  node_bayesian["Bayesian evidence"]
  node_population["Population genetics"]
  node_string_landscape["String landscape"]
  node_physics_tools["Physics tools"]
end

subgraph group_verification["Verification"]
  node_baller_core["Ball arithmetic<br/>[_core.py]"]
  node_baller_blocks["Block certificates<br/>[block_arrow.py]"]
  node_baller_frontdoor["Certified interface<br/>[frontdoor.py]"]
  node_clinch_engine["Certificate engine<br/>[engine.py]"]
  node_clinch_oracle["Certificate oracle<br/>[oracle_v31.py]"]
  node_claim_emitter["Claim checking<br/>[expr.py]"]
  node_stratified_solver["Stratified elimination<br/>[engine.py]"]
  node_coverage_audit["Coverage audit<br/>[coverage.py]"]
end

node_agent(("User agent"))

node_agent -->|"consults"| node_tool_index
node_tool_index -->|"guides planning"| node_plan
node_agent -->|"approves"| node_plan
node_plan -->|"selects instruments"| node_scientific_tools
node_scientific_tools -->|"computes integrals"| node_integration
node_scientific_tools -->|"computes integrals"| node_grassmannian
node_scientific_tools -->|"searches recurrences"| node_recurrences
node_scientific_tools -->|"supports exact reduction"| node_symbolic
node_scientific_tools -->|"computes evidence"| node_bayesian
node_scientific_tools -->|"analyzes populations"| node_population
node_scientific_tools -->|"enumerates cases"| node_string_landscape
node_scientific_tools -->|"supports physics"| node_physics_tools
node_scientific_tools -->|"certifies numerics"| node_baller_core
node_scientific_tools -->|"certifies results"| node_clinch_engine
node_scientific_tools -->|"checks claims"| node_claim_emitter
node_scientific_tools -->|"solves recurrences"| node_stratified_solver
node_scientific_tools -->|"checks completeness"| node_coverage_audit
node_scientific_tools -->|"propagates error bounds"| node_baller_blocks
node_scientific_tools -->|"exposes instruments"| node_baller_frontdoor
node_scientific_tools -->|"supports certification"| node_clinch_oracle
node_scientific_tools -->|"produces results"| node_integration

click node_tool_index "https://github.com/bootloops-ai/bootloops/blob/main/tools/README.md"
click node_scientific_tools "https://github.com/bootloops-ai/bootloops/tree/main/tools"
click node_integration "https://github.com/bootloops-ai/bootloops/tree/main/tools/ellipticus"
click node_grassmannian "https://github.com/bootloops-ai/bootloops/blob/main/tools/tropical-sampler/cegm_gj/x36_engine.py"
click node_recurrences "https://github.com/bootloops-ai/bootloops/blob/main/tools/blade/search.py"
click node_symbolic "https://github.com/bootloops-ai/bootloops/tree/main/tools/annihilator"
click node_bayesian "https://github.com/bootloops-ai/bootloops/tree/main/tools/mixalot"
click node_population "https://github.com/bootloops-ai/bootloops/tree/main/tools/popcorn"
click node_string_landscape "https://github.com/bootloops-ai/bootloops/tree/main/tools/terrier"
click node_physics_tools "https://github.com/bootloops-ai/bootloops/tree/main/tools/pmflow"
click node_baller_core "https://github.com/bootloops-ai/bootloops/blob/main/tools/baller/baller/_core.py"
click node_baller_blocks "https://github.com/bootloops-ai/bootloops/blob/main/tools/baller/baller/block_arrow.py"
click node_baller_frontdoor "https://github.com/bootloops-ai/bootloops/blob/main/tools/baller/baller/frontdoor.py"
click node_clinch_engine "https://github.com/bootloops-ai/bootloops/blob/main/tools/clinch/clinch/engine.py"
click node_clinch_oracle "https://github.com/bootloops-ai/bootloops/blob/main/tools/clinch/clinch/oracle_v31.py"
click node_claim_emitter "https://github.com/bootloops-ai/bootloops/blob/main/tools/emitall/expr.py"
click node_stratified_solver "https://github.com/bootloops-ai/bootloops/blob/main/tools/winnow/ibplapper/engine.py"
click node_coverage_audit "https://github.com/bootloops-ai/bootloops/blob/main/tools/trust/strata/coverage.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tool_index,node_plan,node_scientific_tools,node_agent toneBlue
class node_integration,node_grassmannian,node_recurrences,node_symbolic toneAmber
class node_bayesian,node_population,node_string_landscape,node_physics_tools toneMint
class node_baller_core,node_baller_blocks,node_baller_frontdoor,node_clinch_engine,node_clinch_oracle,node_claim_emitter,node_stratified_solver,node_coverage_audit toneRose
```

## Components

### Agent workflow

- [Tool index](https://github.com/bootloops-ai/bootloops/blob/main/tools/README.md): `tools/README.md`
- **Approved plan**
- [Scientific tools](https://github.com/bootloops-ai/bootloops/tree/main/tools): `tools`

### Scientific computation

- [Integral engines](https://github.com/bootloops-ai/bootloops/tree/main/tools/ellipticus): `tools/ellipticus`
- [Grassmannian integrals](https://github.com/bootloops-ai/bootloops/blob/main/tools/tropical-sampler/cegm_gj/x36_engine.py): `tools/tropical-sampler/cegm_gj/x36_engine.py`
- [Recurrence search](https://github.com/bootloops-ai/bootloops/blob/main/tools/blade/search.py): `tools/blade/search.py`
- [Symbolic methods](https://github.com/bootloops-ai/bootloops/tree/main/tools/annihilator): `tools/annihilator`

### Domain toolkits

- [Bayesian evidence](https://github.com/bootloops-ai/bootloops/tree/main/tools/mixalot): `tools/mixalot`
- [Population genetics](https://github.com/bootloops-ai/bootloops/tree/main/tools/popcorn): `tools/popcorn`
- [String landscape](https://github.com/bootloops-ai/bootloops/tree/main/tools/terrier): `tools/terrier`
- [Physics tools](https://github.com/bootloops-ai/bootloops/tree/main/tools/pmflow): `tools/pmflow`

### Verification

- [Ball arithmetic](https://github.com/bootloops-ai/bootloops/blob/main/tools/baller/baller/_core.py): `tools/baller/baller/_core.py`
- [Block certificates](https://github.com/bootloops-ai/bootloops/blob/main/tools/baller/baller/block_arrow.py): `tools/baller/baller/block_arrow.py`
- [Certified interface](https://github.com/bootloops-ai/bootloops/blob/main/tools/baller/baller/frontdoor.py): `tools/baller/baller/frontdoor.py`
- [Certificate engine](https://github.com/bootloops-ai/bootloops/blob/main/tools/clinch/clinch/engine.py): `tools/clinch/clinch/engine.py`
- [Certificate oracle](https://github.com/bootloops-ai/bootloops/blob/main/tools/clinch/clinch/oracle_v31.py): `tools/clinch/clinch/oracle_v31.py`
- [Claim checking](https://github.com/bootloops-ai/bootloops/blob/main/tools/emitall/expr.py): `tools/emitall/expr.py`
- [Stratified elimination](https://github.com/bootloops-ai/bootloops/blob/main/tools/winnow/ibplapper/engine.py): `tools/winnow/ibplapper/engine.py`
- [Coverage audit](https://github.com/bootloops-ai/bootloops/blob/main/tools/trust/strata/coverage.py): `tools/trust/strata/coverage.py`

### Other components

- **User agent**

## Connections

- User agent → Tool index: consults (evidence: `README.md`)
- Tool index → Approved plan: guides planning (evidence: `README.md`)
- User agent → Approved plan: approves (evidence: `README.md`)
- Approved plan → Scientific tools: selects instruments (evidence: `README.md`)
- Scientific tools → Integral engines: computes integrals (evidence: `README.md`)
- Scientific tools → Grassmannian integrals: computes integrals (evidence: `README.md`)
- Scientific tools → Recurrence search: searches recurrences (evidence: `README.md`)
- Scientific tools → Symbolic methods: supports exact reduction (evidence: `README.md`)
- Scientific tools → Bayesian evidence: computes evidence (evidence: `README.md`)
- Scientific tools → Population genetics: analyzes populations (evidence: `README.md`)
- Scientific tools → String landscape: enumerates cases (evidence: `README.md`)
- Scientific tools → Physics tools: supports physics (evidence: `README.md`)
- Scientific tools → Ball arithmetic: certifies numerics (evidence: `README.md`)
- Scientific tools → Certificate engine: certifies results (evidence: `README.md`)
- Scientific tools → Claim checking: checks claims (evidence: `README.md`)
- Scientific tools → Stratified elimination: solves recurrences (evidence: `README.md`)
- Scientific tools → Coverage audit: checks completeness (evidence: `README.md`)
- Scientific tools → Block certificates: propagates error bounds (evidence: `README.md`)
- Scientific tools → Certified interface: exposes instruments (evidence: `README.md`)
- Scientific tools → Certificate oracle: supports certification (evidence: `README.md`)
- Scientific tools → Integral engines: produces results (evidence: `README.md`)
