# exo-lang/exo architecture

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

- Interactive diagram: https://gitdiagram.com/exo-lang/exo
- Repository: https://github.com/exo-lang/exo

## Overview

Exo is a Python-based exocompiler for writing and scheduling loop-oriented tensor procedures, then generating C and headers for target hardware. The principal workflow is author a procedure, transform it with scheduling operations, and compile it. Its internal layers include Python-to-LoopIR parsing, IR rewrites and analyses, and target-aware C code generation; memory models and hardware platform support provide important additional capabilities. Several relationships below are documented by the README or SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`src/exo/core/LoopIR.py`](https://github.com/exo-lang/exo/blob/main/src/exo/core/LoopIR.py) (LoopIR), [`src/exo/API.py`](https://github.com/exo-lang/exo/blob/main/src/exo/API.py) (Procedure API), [`src/exo/backend/LoopIR_compiler.py`](https://github.com/exo-lang/exo/blob/main/src/exo/backend/LoopIR_compiler.py) (C Compiler), [`src/exo/stdlib/scheduling.py`](https://github.com/exo-lang/exo/blob/main/src/exo/stdlib/scheduling.py) (Scheduling Library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring and API"]
  node_cli["Exocc CLI<br/>[main.py]"]
  node_public_api["Procedure API<br/>[API.py]"]
  node_python_parser["Python Parser<br/>[pyparser.py]"]
  node_fragment_parser["Fragment Parser<br/>[parse_fragment.py]"]
end

subgraph group_ir["IR and Scheduling"]
  node_schedule_api["Scheduling API<br/>[API_scheduling.py]"]
  node_cursor_api["Cursor API<br/>[API_cursors.py]"]
  node_stdlib_schedule["Scheduling Library<br/>[scheduling.py]"]
  node_stdlib_compose["Schedule Compositions<br/>[stdlib.py]"]
  node_inspection["IR Inspection<br/>[inspection.py]"]
  node_loopir["LoopIR<br/>[LoopIR.py]"]
  node_rewrites["IR Rewrites"]
end

subgraph group_codegen["Analysis and Codegen"]
  node_effect_analysis["Effect Analysis<br/>[new_eff.py]"]
  node_range_analysis["Range Analysis<br/>[range_analysis.py]"]
  node_compiler["C Compiler<br/>[LoopIR_compiler.py]"]
end

subgraph group_targets["Memory and Targets"]
  node_memory_model["Memory Models<br/>[memory.py]"]
  node_memory_library["Target Memories<br/>[memories.py]"]
  node_gemmini["Gemmini Platform<br/>[gemmini.py]"]
  node_neon["NEON Platform<br/>[neon.py]"]
  node_x86["x86 Platform<br/>[x86.py]"]
end

node_developer(("Exo Developer"))
node_generated_c["Generated C and Header"]

node_developer -->|"runs compiler"| node_cli
node_developer -.->|"defines procedures"| node_public_api
node_cli -->|"loads API"| node_public_api
node_cli -->|"emits C and header"| node_generated_c
node_python_parser -->|"builds IR"| node_loopir
node_fragment_parser -->|"uses parser"| node_python_parser
node_fragment_parser -->|"builds fragments"| node_loopir
node_stdlib_schedule -->|"exposes operations"| node_schedule_api
node_stdlib_schedule -->|"uses cursors"| node_cursor_api
node_stdlib_compose -->|"composes schedules"| node_stdlib_schedule
node_stdlib_compose -->|"uses inspection"| node_inspection
node_rewrites -->|"rewrites IR"| node_loopir
node_rewrites -->|"uses effects"| node_effect_analysis
node_rewrites -->|"uses ranges"| node_range_analysis
node_loopir -->|"represents memory"| node_memory_model
node_compiler -->|"compiles IR"| node_loopir
node_compiler -->|"uses ranges"| node_range_analysis
node_compiler -->|"generates memory code"| node_memory_model
node_compiler -.->|"emits C"| node_generated_c
node_memory_library -->|"implements memories"| node_memory_model
node_gemmini -->|"uses memories"| node_memory_library
node_gemmini -->|"uses schedules"| node_stdlib_schedule
node_gemmini -->|"uses procedure API"| node_public_api
node_neon -->|"uses procedure API"| node_public_api
node_x86 -->|"uses memories"| node_memory_library
node_x86 -->|"uses procedure API"| node_public_api

click node_cli "https://github.com/exo-lang/exo/blob/main/src/exo/main.py"
click node_public_api "https://github.com/exo-lang/exo/blob/main/src/exo/API.py"
click node_python_parser "https://github.com/exo-lang/exo/blob/main/src/exo/frontend/pyparser.py"
click node_fragment_parser "https://github.com/exo-lang/exo/blob/main/src/exo/frontend/parse_fragment.py"
click node_schedule_api "https://github.com/exo-lang/exo/blob/main/src/exo/API_scheduling.py"
click node_cursor_api "https://github.com/exo-lang/exo/blob/main/src/exo/API_cursors.py"
click node_stdlib_schedule "https://github.com/exo-lang/exo/blob/main/src/exo/stdlib/scheduling.py"
click node_stdlib_compose "https://github.com/exo-lang/exo/blob/main/src/exo/stdlib/stdlib.py"
click node_inspection "https://github.com/exo-lang/exo/blob/main/src/exo/stdlib/inspection.py"
click node_loopir "https://github.com/exo-lang/exo/blob/main/src/exo/core/LoopIR.py"
click node_rewrites "https://github.com/exo-lang/exo/blob/main/src/exo/rewrite/LoopIR_scheduling.py"
click node_effect_analysis "https://github.com/exo-lang/exo/blob/main/src/exo/rewrite/new_eff.py"
click node_range_analysis "https://github.com/exo-lang/exo/blob/main/src/exo/rewrite/range_analysis.py"
click node_compiler "https://github.com/exo-lang/exo/blob/main/src/exo/backend/LoopIR_compiler.py"
click node_memory_model "https://github.com/exo-lang/exo/blob/main/src/exo/core/memory.py"
click node_memory_library "https://github.com/exo-lang/exo/blob/main/src/exo/libs/memories.py"
click node_gemmini "https://github.com/exo-lang/exo/blob/main/src/exo/platforms/gemmini.py"
click node_neon "https://github.com/exo-lang/exo/blob/main/src/exo/platforms/neon.py"
click node_x86 "https://github.com/exo-lang/exo/blob/main/src/exo/platforms/x86.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_cli,node_public_api,node_python_parser,node_fragment_parser toneBlue
class node_schedule_api,node_cursor_api,node_stdlib_schedule,node_stdlib_compose,node_inspection,node_loopir,node_rewrites toneAmber
class node_effect_analysis,node_range_analysis,node_compiler toneMint
class node_memory_model,node_memory_library,node_gemmini,node_neon,node_x86 toneRose
class node_developer,node_generated_c toneIndigo
```

## Components

### Authoring and API

- [Exocc CLI](https://github.com/exo-lang/exo/blob/main/src/exo/main.py): `src/exo/main.py`
- [Procedure API](https://github.com/exo-lang/exo/blob/main/src/exo/API.py): `src/exo/API.py`
- [Python Parser](https://github.com/exo-lang/exo/blob/main/src/exo/frontend/pyparser.py): `src/exo/frontend/pyparser.py`
- [Fragment Parser](https://github.com/exo-lang/exo/blob/main/src/exo/frontend/parse_fragment.py): `src/exo/frontend/parse_fragment.py`

### IR and Scheduling

- [Scheduling API](https://github.com/exo-lang/exo/blob/main/src/exo/API_scheduling.py): `src/exo/API_scheduling.py`
- [Cursor API](https://github.com/exo-lang/exo/blob/main/src/exo/API_cursors.py): `src/exo/API_cursors.py`
- [Scheduling Library](https://github.com/exo-lang/exo/blob/main/src/exo/stdlib/scheduling.py): `src/exo/stdlib/scheduling.py`
- [Schedule Compositions](https://github.com/exo-lang/exo/blob/main/src/exo/stdlib/stdlib.py): `src/exo/stdlib/stdlib.py`
- [IR Inspection](https://github.com/exo-lang/exo/blob/main/src/exo/stdlib/inspection.py): `src/exo/stdlib/inspection.py`
- [LoopIR](https://github.com/exo-lang/exo/blob/main/src/exo/core/LoopIR.py): `src/exo/core/LoopIR.py`
- [IR Rewrites](https://github.com/exo-lang/exo/blob/main/src/exo/rewrite/LoopIR_scheduling.py): `src/exo/rewrite/LoopIR_scheduling.py`

### Analysis and Codegen

- [Effect Analysis](https://github.com/exo-lang/exo/blob/main/src/exo/rewrite/new_eff.py): `src/exo/rewrite/new_eff.py`
- [Range Analysis](https://github.com/exo-lang/exo/blob/main/src/exo/rewrite/range_analysis.py): `src/exo/rewrite/range_analysis.py`
- [C Compiler](https://github.com/exo-lang/exo/blob/main/src/exo/backend/LoopIR_compiler.py): `src/exo/backend/LoopIR_compiler.py`

### Memory and Targets

- [Memory Models](https://github.com/exo-lang/exo/blob/main/src/exo/core/memory.py): `src/exo/core/memory.py`
- [Target Memories](https://github.com/exo-lang/exo/blob/main/src/exo/libs/memories.py): `src/exo/libs/memories.py`
- [Gemmini Platform](https://github.com/exo-lang/exo/blob/main/src/exo/platforms/gemmini.py): `src/exo/platforms/gemmini.py`
- [NEON Platform](https://github.com/exo-lang/exo/blob/main/src/exo/platforms/neon.py): `src/exo/platforms/neon.py`
- [x86 Platform](https://github.com/exo-lang/exo/blob/main/src/exo/platforms/x86.py): `src/exo/platforms/x86.py`

### Other components

- **Exo Developer**
- **Generated C and Header**

## Connections

- Exo Developer → Exocc CLI: runs compiler (evidence: `README.md`)
- Exo Developer → Procedure API: defines procedures
- Exocc CLI → Procedure API: loads API (evidence: `src/exo/main.py`)
- Exocc CLI → Generated C and Header: emits C and header (evidence: `README.md`)
- Python Parser → LoopIR: builds IR (evidence: `src/exo/frontend/pyparser.py`)
- Fragment Parser → Python Parser: uses parser (evidence: `src/exo/frontend/parse_fragment.py`)
- Fragment Parser → LoopIR: builds fragments (evidence: `src/exo/frontend/parse_fragment.py`)
- Scheduling Library → Scheduling API: exposes operations (evidence: `src/exo/stdlib/scheduling.py`)
- Scheduling Library → Cursor API: uses cursors (evidence: `src/exo/stdlib/scheduling.py`)
- Schedule Compositions → Scheduling Library: composes schedules (evidence: `src/exo/stdlib/stdlib.py`)
- Schedule Compositions → IR Inspection: uses inspection (evidence: `src/exo/stdlib/stdlib.py`)
- IR Rewrites → LoopIR: rewrites IR (evidence: `src/exo/rewrite/LoopIR_scheduling.py`)
- IR Rewrites → Effect Analysis: uses effects (evidence: `src/exo/rewrite/LoopIR_scheduling.py`)
- IR Rewrites → Range Analysis: uses ranges (evidence: `src/exo/rewrite/LoopIR_scheduling.py`)
- LoopIR → Memory Models: represents memory (evidence: `src/exo/core/LoopIR.py`)
- C Compiler → LoopIR: compiles IR (evidence: `src/exo/backend/LoopIR_compiler.py`)
- C Compiler → Range Analysis: uses ranges (evidence: `src/exo/backend/LoopIR_compiler.py`)
- C Compiler → Memory Models: generates memory code (evidence: `src/exo/backend/LoopIR_compiler.py`)
- C Compiler → Generated C and Header: emits C
- Target Memories → Memory Models: implements memories (evidence: `src/exo/libs/memories.py`)
- Gemmini Platform → Target Memories: uses memories (evidence: `src/exo/platforms/gemmini.py`)
- Gemmini Platform → Scheduling Library: uses schedules (evidence: `src/exo/platforms/gemmini.py`)
- Gemmini Platform → Procedure API: uses procedure API (evidence: `src/exo/platforms/gemmini.py`)
- NEON Platform → Procedure API: uses procedure API (evidence: `src/exo/platforms/neon.py`)
- x86 Platform → Target Memories: uses memories (evidence: `src/exo/platforms/x86.py`)
- x86 Platform → Procedure API: uses procedure API (evidence: `src/exo/platforms/x86.py`)
