# openai/math architecture

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

- Interactive diagram: https://gitdiagram.com/openai/math
- Repository: https://github.com/openai/math
- Video tour (about a minute): https://gitdiagram.com/openai/math/video

## Overview

This repository is a research-results collection: readers navigate a catalogue of manuscript families, access manuscripts and supporting materials, and consult Lean formalizations where available. The README identifies the overview, manuscript map, preprints, Lean library, and formalization catalogue as navigation points, and describes comparator instructions for checking. The tree shows formalization work under two Lean namespaces, including a Hodge-conjecture comparator project and OAI material. No source excerpts were provided, so the graph limits relationships to those explicitly documented in the README.

Main entry points: [`lean`](https://github.com/openai/math/tree/main/lean) (Lean library), [`lean/ComparatorChallenges`](https://github.com/openai/math/tree/main/lean/ComparatorChallenges) (Comparator instructions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Research catalogue"]
  node_overview["Family overview"]
  node_manuscript_map["Manuscript map"]
  node_history["Repository history"]
end

subgraph group_papers["Manuscripts"]
  node_preprints["Preprints"]
end

subgraph group_formalization["Lean formalizations"]
  node_lean_library["Lean library"]
  node_formalization_catalog["Formalization catalogue"]
  node_comparator["Comparator instructions"]
  node_hodge["Hodge formalization"]
  node_oai["OAI formalizations"]
end

node_reader(("Reader"))

node_reader -->|"consults"| node_overview
node_reader -->|"uses to find"| node_manuscript_map
node_reader -->|"accesses"| node_preprints
node_reader -->|"consults"| node_lean_library
node_lean_library -->|"describes proofs"| node_formalization_catalog
node_lean_library -->|"points to instructions"| node_comparator
node_manuscript_map -->|"locates"| node_preprints
node_reader -->|"checks updates"| node_history

click node_lean_library "https://github.com/openai/math/tree/main/lean"
click node_comparator "https://github.com/openai/math/tree/main/lean/ComparatorChallenges"
click node_hodge "https://github.com/openai/math/tree/main/lean/ComparatorChallenges/HodgeConjectureCMAbelianVarieties"
click node_oai "https://github.com/openai/math/tree/main/lean/OAI"

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_overview,node_manuscript_map,node_history toneBlue
class node_preprints toneAmber
class node_lean_library,node_formalization_catalog,node_comparator,node_hodge,node_oai toneMint
class node_reader toneIndigo
```

## Components

### Research catalogue

- **Family overview**
- **Manuscript map**
- **Repository history**

### Manuscripts

- **Preprints**

### Lean formalizations

- [Lean library](https://github.com/openai/math/tree/main/lean): `lean`
- **Formalization catalogue**
- [Comparator instructions](https://github.com/openai/math/tree/main/lean/ComparatorChallenges): `lean/ComparatorChallenges`
- [Hodge formalization](https://github.com/openai/math/tree/main/lean/ComparatorChallenges/HodgeConjectureCMAbelianVarieties): `lean/ComparatorChallenges/HodgeConjectureCMAbelianVarieties`
- [OAI formalizations](https://github.com/openai/math/tree/main/lean/OAI): `lean/OAI`

### Other components

- **Reader**

## Connections

- Reader → Family overview: consults
- Reader → Manuscript map: uses to find
- Reader → Preprints: accesses
- Reader → Lean library: consults
- Lean library → Formalization catalogue: describes proofs
- Lean library → Comparator instructions: points to instructions
- Manuscript map → Preprints: locates
- Reader → Repository history: checks updates
