# ed-donner/llm_engineering architecture

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

- Interactive diagram: https://gitdiagram.com/ed-donner/llm_engineering
- Repository: https://github.com/ed-donner/llm_engineering

## Overview

This repository is an educational course and collection of hands-on LLM projects, not a single application. The learner’s workflow is to progress through weekly exercises, building from basic model and web tasks toward retrieval, evaluation, and autonomous agents. The README documents that projects build on one another and culminate in an agentic AI solution in Week 8. The tree shows representative exercises; connections between individual projects are not established here, so the graph shows only the documented course progression.

Main entry points: [`week1`](https://github.com/ed-donner/llm_engineering/tree/main/week1) (Week 1 projects), [`week2`](https://github.com/ed-donner/llm_engineering/tree/main/week2) (Week 2 projects), [`week5/app.py`](https://github.com/ed-donner/llm_engineering/blob/main/week5/app.py) (Week 5 projects), [`week8`](https://github.com/ed-donner/llm_engineering/tree/main/week8) (Week 8 projects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Foundations"]
  node_week1["Week 1 projects"]
  node_web_scraping["Web scraping<br/>[scraper.py]"]
  node_brochure["Brochure generation"]
  node_week2["Week 2 projects"]
end

subgraph group_applications["LLM Applications"]
  node_support_chat["Customer support<br/>[app.py]"]
  node_synthetic_data["Synthetic data<br/>[app.py]"]
  node_code_assistant["Code assistant<br/>[main.py]"]
  node_week5["Week 5 projects<br/>[app.py]"]
  node_retrieval["Retrieval answers<br/>[answer.py]"]
end

subgraph group_advanced["Advanced Methods"]
  node_week6["Week 6 projects"]
  node_week7["Week 7 projects"]
  node_pricing["Pricing pipeline"]
end

subgraph group_agents["Agentic Projects"]
  node_week8["Week 8 projects"]
  node_autonomous_agent["Autonomous agents<br/>[app.py]"]
  node_news_agents["News intelligence<br/>[app.py]"]
end

node_learner(("Course learner"))

node_learner -->|"starts course"| node_week1
node_week1 -->|"progresses to"| node_week2
node_week2 -->|"builds toward"| node_week5
node_week5 -->|"culminates in"| node_week8
node_week1 -->|"includes"| node_web_scraping
node_week1 -->|"includes"| node_brochure
node_week2 -->|"includes"| node_support_chat
node_week8 -->|"includes"| node_autonomous_agent

click node_week1 "https://github.com/ed-donner/llm_engineering/tree/main/week1"
click node_web_scraping "https://github.com/ed-donner/llm_engineering/blob/main/week1/scraper.py"
click node_brochure "https://github.com/ed-donner/llm_engineering/blob/main/week1/community-contributions/brochure_pipeline.py"
click node_week2 "https://github.com/ed-donner/llm_engineering/tree/main/week2"
click node_support_chat "https://github.com/ed-donner/llm_engineering/blob/main/week2/community-contributions/internet_customer_support/app.py"
click node_synthetic_data "https://github.com/ed-donner/llm_engineering/blob/main/week3/community-contributions/test_data_generator/app.py"
click node_code_assistant "https://github.com/ed-donner/llm_engineering/blob/main/week4/community-contributions/tsungyulin_code_accelerate/main.py"
click node_week5 "https://github.com/ed-donner/llm_engineering/blob/main/week5/app.py"
click node_retrieval "https://github.com/ed-donner/llm_engineering/blob/main/week5/implementation/answer.py"
click node_week6 "https://github.com/ed-donner/llm_engineering/tree/main/week6"
click node_week7 "https://github.com/ed-donner/llm_engineering/tree/main/week7"
click node_pricing "https://github.com/ed-donner/llm_engineering/blob/main/week7/community_contributions/CynthiaOmovoiye/pricing_pipeline.py"
click node_week8 "https://github.com/ed-donner/llm_engineering/tree/main/week8"
click node_autonomous_agent "https://github.com/ed-donner/llm_engineering/blob/main/week8/community_contributions/JamesDominiqueAI/app.py"
click node_news_agents "https://github.com/ed-donner/llm_engineering/blob/main/community-contributions/mugisha_caleb_didier/week8/app.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_week1,node_web_scraping,node_brochure,node_week2 toneBlue
class node_support_chat,node_synthetic_data,node_code_assistant,node_week5,node_retrieval toneAmber
class node_week6,node_week7,node_pricing toneMint
class node_week8,node_autonomous_agent,node_news_agents toneRose
class node_learner toneIndigo
```

## Components

### Foundations

- [Week 1 projects](https://github.com/ed-donner/llm_engineering/tree/main/week1): `week1`
- [Web scraping](https://github.com/ed-donner/llm_engineering/blob/main/week1/scraper.py): `week1/scraper.py`
- [Brochure generation](https://github.com/ed-donner/llm_engineering/blob/main/week1/community-contributions/brochure_pipeline.py): `week1/community-contributions/brochure_pipeline.py`
- [Week 2 projects](https://github.com/ed-donner/llm_engineering/tree/main/week2): `week2`

### LLM Applications

- [Customer support](https://github.com/ed-donner/llm_engineering/blob/main/week2/community-contributions/internet_customer_support/app.py): `week2/community-contributions/internet_customer_support/app.py`
- [Synthetic data](https://github.com/ed-donner/llm_engineering/blob/main/week3/community-contributions/test_data_generator/app.py): `week3/community-contributions/test_data_generator/app.py`
- [Code assistant](https://github.com/ed-donner/llm_engineering/blob/main/week4/community-contributions/tsungyulin_code_accelerate/main.py): `week4/community-contributions/tsungyulin_code_accelerate/main.py`
- [Week 5 projects](https://github.com/ed-donner/llm_engineering/blob/main/week5/app.py): `week5/app.py`
- [Retrieval answers](https://github.com/ed-donner/llm_engineering/blob/main/week5/implementation/answer.py): `week5/implementation/answer.py`

### Advanced Methods

- [Week 6 projects](https://github.com/ed-donner/llm_engineering/tree/main/week6): `week6`
- [Week 7 projects](https://github.com/ed-donner/llm_engineering/tree/main/week7): `week7`
- [Pricing pipeline](https://github.com/ed-donner/llm_engineering/blob/main/week7/community_contributions/CynthiaOmovoiye/pricing_pipeline.py): `week7/community_contributions/CynthiaOmovoiye/pricing_pipeline.py`

### Agentic Projects

- [Week 8 projects](https://github.com/ed-donner/llm_engineering/tree/main/week8): `week8`
- [Autonomous agents](https://github.com/ed-donner/llm_engineering/blob/main/week8/community_contributions/JamesDominiqueAI/app.py): `week8/community_contributions/JamesDominiqueAI/app.py`
- [News intelligence](https://github.com/ed-donner/llm_engineering/blob/main/community-contributions/mugisha_caleb_didier/week8/app.py): `community-contributions/mugisha_caleb_didier/week8/app.py`

### Other components

- **Course learner**

## Connections

- Course learner → Week 1 projects: starts course (evidence: `README.md`)
- Week 1 projects → Week 2 projects: progresses to (evidence: `README.md`)
- Week 2 projects → Week 5 projects: builds toward (evidence: `README.md`)
- Week 5 projects → Week 8 projects: culminates in (evidence: `README.md`)
- Week 1 projects → Web scraping: includes (evidence: `README.md`)
- Week 1 projects → Brochure generation: includes (evidence: `README.md`)
- Week 2 projects → Customer support: includes (evidence: `README.md`)
- Week 8 projects → Autonomous agents: includes (evidence: `README.md`)
