# bojieli/ai-infra-book architecture

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

- Interactive diagram: https://gitdiagram.com/bojieli/ai-infra-book
- Repository: https://github.com/bojieli/ai-infra-book

## Overview

This repository is an AI infrastructure textbook, accompanied by resource-calculation tools and chapter-organized experiments. The main reader workflow is to study the chapters, use calculations to test resource estimates, and consult experiments for measured or reproducible examples. The README documents multilingual editions and research, case-study, and reference collections. Source excerpts are sparse and mostly concern external framework snapshots, so internal links among these collections are omitted rather than inferred.

Main entry points: [`calculations/calc.py`](https://github.com/bojieli/ai-infra-book/blob/main/calculations/calc.py) (Calculation CLI), [`manuscripts`](https://github.com/bojieli/ai-infra-book/tree/main/manuscripts) (Twelve-chapter manuscript), [`calculations`](https://github.com/bojieli/ai-infra-book/tree/main/calculations) (Resource calculations), [`calculations/src/infra_calc/topics/training_pipeline_schedule.py`](https://github.com/bojieli/ai-infra-book/blob/main/calculations/src/infra_calc/topics/training_pipeline_schedule.py) (Training schedule model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_book["Book content"]
  node_manuscripts["Twelve-chapter manuscript"]
end

subgraph group_tools["Companion tools"]
  node_calculations["Resource calculations"]
  node_calc_cli["Calculation CLI<br/>[calc.py]"]
  node_training_schedule["Training schedule model"]
end

subgraph group_evidence["Supporting evidence"]
  node_experiments["Chapter experiments"]
  node_case_studies["System case studies"]
  node_research["Topic research"]
  node_references["Reference library"]
end

subgraph group_editions["Language editions"]
  node_english["English edition"]
  node_traditional["Traditional Chinese edition"]
end

node_reader(("Engineer or student"))

node_reader -->|"reads chapters"| node_manuscripts
node_reader -->|"runs estimates"| node_calc_cli
node_calc_cli -->|"uses calculations"| node_calculations
node_reader -->|"explores schedules"| node_training_schedule
node_reader -->|"consults experiments"| node_experiments
node_reader -->|"studies cases"| node_case_studies
node_reader -->|"consults research"| node_research
node_reader -->|"checks sources"| node_references
node_reader -.->|"reads translation"| node_english
node_reader -.->|"reads translation"| node_traditional

click node_manuscripts "https://github.com/bojieli/ai-infra-book/tree/main/manuscripts"
click node_calculations "https://github.com/bojieli/ai-infra-book/tree/main/calculations"
click node_calc_cli "https://github.com/bojieli/ai-infra-book/blob/main/calculations/calc.py"
click node_training_schedule "https://github.com/bojieli/ai-infra-book/blob/main/calculations/src/infra_calc/topics/training_pipeline_schedule.py"
click node_experiments "https://github.com/bojieli/ai-infra-book/tree/main/experiments"
click node_case_studies "https://github.com/bojieli/ai-infra-book/tree/main/case-studies"
click node_research "https://github.com/bojieli/ai-infra-book/tree/main/research"
click node_references "https://github.com/bojieli/ai-infra-book/tree/main/references"
click node_english "https://github.com/bojieli/ai-infra-book/tree/main/book-en"
click node_traditional "https://github.com/bojieli/ai-infra-book/tree/main/book-zh-tw"

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_manuscripts toneBlue
class node_calculations,node_calc_cli,node_training_schedule toneAmber
class node_experiments,node_case_studies,node_research,node_references toneMint
class node_english,node_traditional toneRose
class node_reader toneIndigo
```

## Components

### Book content

- [Twelve-chapter manuscript](https://github.com/bojieli/ai-infra-book/tree/main/manuscripts): `manuscripts`

### Companion tools

- [Resource calculations](https://github.com/bojieli/ai-infra-book/tree/main/calculations): `calculations`
- [Calculation CLI](https://github.com/bojieli/ai-infra-book/blob/main/calculations/calc.py): `calculations/calc.py`
- [Training schedule model](https://github.com/bojieli/ai-infra-book/blob/main/calculations/src/infra_calc/topics/training_pipeline_schedule.py): `calculations/src/infra_calc/topics/training_pipeline_schedule.py`

### Supporting evidence

- [Chapter experiments](https://github.com/bojieli/ai-infra-book/tree/main/experiments): `experiments`
- [System case studies](https://github.com/bojieli/ai-infra-book/tree/main/case-studies): `case-studies`
- [Topic research](https://github.com/bojieli/ai-infra-book/tree/main/research): `research`
- [Reference library](https://github.com/bojieli/ai-infra-book/tree/main/references): `references`

### Language editions

- [English edition](https://github.com/bojieli/ai-infra-book/tree/main/book-en): `book-en`
- [Traditional Chinese edition](https://github.com/bojieli/ai-infra-book/tree/main/book-zh-tw): `book-zh-tw`

### Other components

- **Engineer or student**

## Connections

- Engineer or student → Twelve-chapter manuscript: reads chapters
- Engineer or student → Calculation CLI: runs estimates
- Calculation CLI → Resource calculations: uses calculations
- Engineer or student → Training schedule model: explores schedules
- Engineer or student → Chapter experiments: consults experiments
- Engineer or student → System case studies: studies cases
- Engineer or student → Topic research: consults research
- Engineer or student → Reference library: checks sources
- Engineer or student → English edition: reads translation
- Engineer or student → Traditional Chinese edition: reads translation