# rajeshmar/llm_engineering architecture

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

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

## Overview

This repository is an educational course collection, not one integrated runtime application. Its principal learner workflow is to work through weekly hands-on projects, run them, inspect their results, and adapt them; the README describes Week 8’s autonomous-agent solution as building on earlier weeks. The graph preserves major sampled project areas and indexed core modules as parallel examples rather than implying they form a shared execution pipeline. Connections between individual projects are not established by the excerpts, so those are left unlinked.

Main entry points: [`week1`](https://github.com/rajeshmar/llm_engineering/tree/main/week1) (Weeks 1–4 projects), [`week5`](https://github.com/rajeshmar/llm_engineering/tree/main/week5) (Week 5 projects), [`week6`](https://github.com/rajeshmar/llm_engineering/tree/main/week6) (Week 6–7 pricing), [`community-contributions/dng/week8/main.py`](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/dng/week8/main.py) (Deal-finder interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course progression"]
  node_early["Weeks 1–4 projects"]
  node_retrieval["Week 5 projects"]
  node_pricing["Week 6–7 pricing"]
end

subgraph group_reputation["Reputation analysis"]
  node_radar_ui["Radar dashboard<br/>[dashboard.py]"]
  node_radar_filters["Radar filters<br/>[filters.py]"]
  node_radar_llm["Sentiment analysis<br/>[llm.py]"]
  node_radar_reddit["Reddit collection<br/>[reddit_client.py]"]
  node_radar_trustpilot["Trustpilot collection"]
  node_radar_twitter["Twitter collection<br/>[twitter_client.py]"]
end

subgraph group_decision["Decision analysis"]
  node_decision_app["Decision interface<br/>[app.py]"]
  node_decision_engine["Bayesian decision model"]
end

subgraph group_knowledge["Knowledge assistance"]
  node_knowledge_app["KnowledgeHub interface<br/>[app.py]"]
  node_knowledge_agents["KnowledgeHub agents"]
end

subgraph group_agents["Agent projects"]
  node_week8_main["Deal-finder interface<br/>[main.py]"]
  node_deal_framework["Deal agent framework"]
  node_mugisha_app["Agent application<br/>[app.py]"]
  node_mugisha_framework["Agent framework<br/>[framework.py]"]
  node_geraldino_agents["Agent implementation<br/>[agents.py]"]
  node_chrys_config["Agent configuration<br/>[config.py]"]
  node_week8_framework["Course agent framework"]
end

node_learner(("Learner"))

node_learner -->|"works through"| node_early
node_early -->|"progresses to"| node_retrieval
node_retrieval -->|"progresses to"| node_pricing
node_pricing -->|"builds toward"| node_week8_main
node_week8_main -->|"creates"| node_deal_framework
node_mugisha_app -->|"uses"| node_mugisha_framework
node_decision_app -->|"constructs"| node_decision_engine
node_knowledge_app -.->|"uses"| node_knowledge_agents

click node_early "https://github.com/rajeshmar/llm_engineering/tree/main/week1"
click node_retrieval "https://github.com/rajeshmar/llm_engineering/tree/main/week5"
click node_pricing "https://github.com/rajeshmar/llm_engineering/tree/main/week6"
click node_radar_ui "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/components/dashboard.py"
click node_radar_filters "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/components/filters.py"
click node_radar_llm "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/llm.py"
click node_radar_reddit "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/reddit_client.py"
click node_radar_trustpilot "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/trustpilot_scraper.py"
click node_radar_twitter "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/twitter_client.py"
click node_decision_app "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/decision_bn/app.py"
click node_decision_engine "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/decision_bn/bn_decision_maker/bn_decision_maker.py"
click node_knowledge_app "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/sach91-bootcamp/week8/app.py"
click node_knowledge_agents "https://github.com/rajeshmar/llm_engineering/tree/main/community-contributions/sach91-bootcamp/week8/agents"
click node_week8_main "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/dng/week8/main.py"
click node_deal_framework "https://github.com/rajeshmar/llm_engineering/blob/main/week8/deal_agent_framework.py"
click node_mugisha_app "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/mugisha_caleb_didier/week8/app.py"
click node_mugisha_framework "https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/mugisha_caleb_didier/week8/framework.py"
click node_geraldino_agents "https://github.com/rajeshmar/llm_engineering/blob/main/week8/community_contributions/geraldino/agent/agents.py"
click node_chrys_config "https://github.com/rajeshmar/llm_engineering/blob/main/week8/community_contributions/chrys/config.py"
click node_week8_framework "https://github.com/rajeshmar/llm_engineering/blob/main/week8/deal_agent_framework.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_early,node_retrieval,node_pricing toneBlue
class node_radar_ui,node_radar_filters,node_radar_llm,node_radar_reddit,node_radar_trustpilot,node_radar_twitter toneAmber
class node_decision_app,node_decision_engine toneMint
class node_knowledge_app,node_knowledge_agents toneRose
class node_week8_main,node_deal_framework,node_mugisha_app,node_mugisha_framework,node_geraldino_agents,node_chrys_config,node_week8_framework,node_learner toneIndigo
```

## Components

### Course progression

- [Weeks 1–4 projects](https://github.com/rajeshmar/llm_engineering/tree/main/week1): `week1`
- [Week 5 projects](https://github.com/rajeshmar/llm_engineering/tree/main/week5): `week5`
- [Week 6–7 pricing](https://github.com/rajeshmar/llm_engineering/tree/main/week6): `week6`

### Reputation analysis

- [Radar dashboard](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/components/dashboard.py): `community-contributions/Reputation_Radar/components/dashboard.py`
- [Radar filters](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/components/filters.py): `community-contributions/Reputation_Radar/components/filters.py`
- [Sentiment analysis](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/llm.py): `community-contributions/Reputation_Radar/services/llm.py`
- [Reddit collection](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/reddit_client.py): `community-contributions/Reputation_Radar/services/reddit_client.py`
- [Trustpilot collection](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/trustpilot_scraper.py): `community-contributions/Reputation_Radar/services/trustpilot_scraper.py`
- [Twitter collection](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/Reputation_Radar/services/twitter_client.py): `community-contributions/Reputation_Radar/services/twitter_client.py`

### Decision analysis

- [Decision interface](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/decision_bn/app.py): `community-contributions/decision_bn/app.py`
- [Bayesian decision model](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/decision_bn/bn_decision_maker/bn_decision_maker.py): `community-contributions/decision_bn/bn_decision_maker/bn_decision_maker.py`

### Knowledge assistance

- [KnowledgeHub interface](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/sach91-bootcamp/week8/app.py): `community-contributions/sach91-bootcamp/week8/app.py`
- [KnowledgeHub agents](https://github.com/rajeshmar/llm_engineering/tree/main/community-contributions/sach91-bootcamp/week8/agents): `community-contributions/sach91-bootcamp/week8/agents`

### Agent projects

- [Deal-finder interface](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/dng/week8/main.py): `community-contributions/dng/week8/main.py`
- [Deal agent framework](https://github.com/rajeshmar/llm_engineering/blob/main/week8/deal_agent_framework.py): `week8/deal_agent_framework.py`
- [Agent application](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/mugisha_caleb_didier/week8/app.py): `community-contributions/mugisha_caleb_didier/week8/app.py`
- [Agent framework](https://github.com/rajeshmar/llm_engineering/blob/main/community-contributions/mugisha_caleb_didier/week8/framework.py): `community-contributions/mugisha_caleb_didier/week8/framework.py`
- [Agent implementation](https://github.com/rajeshmar/llm_engineering/blob/main/week8/community_contributions/geraldino/agent/agents.py): `week8/community_contributions/geraldino/agent/agents.py`
- [Agent configuration](https://github.com/rajeshmar/llm_engineering/blob/main/week8/community_contributions/chrys/config.py): `week8/community_contributions/chrys/config.py`
- [Course agent framework](https://github.com/rajeshmar/llm_engineering/blob/main/week8/deal_agent_framework.py): `week8/deal_agent_framework.py`

### Other components

- **Learner**

## Connections

- Learner → Weeks 1–4 projects: works through (evidence: `README.md`)
- Weeks 1–4 projects → Week 5 projects: progresses to (evidence: `README.md`)
- Week 5 projects → Week 6–7 pricing: progresses to (evidence: `README.md`)
- Week 6–7 pricing → Deal-finder interface: builds toward (evidence: `README.md`)
- Deal-finder interface → Deal agent framework: creates (evidence: `community-contributions/dng/week8/main.py`)
- Agent application → Agent framework: uses (evidence: `community-contributions/mugisha_caleb_didier/week8/app.py`)
- Decision interface → Bayesian decision model: constructs (evidence: `community-contributions/decision_bn/app.py`)
- KnowledgeHub interface → KnowledgeHub agents: uses
