# daykalif/hello-agents architecture

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

- Interactive diagram: https://gitdiagram.com/daykalif/hello-agents
- Repository: https://github.com/daykalif/hello-agents

## Overview

Hello-Agents is an open, practice-oriented curriculum for understanding and building AI-native agents, rather than a single deployed agent product. The learner moves from agent and LLM fundamentals through agent patterns and framework construction, then into memory, context, protocols, training, and evaluation, before applying those ideas in larger projects. The graph preserves the README’s major learning branches; only the code paths present in the supplied tree or excerpts are attached to nodes. Other chapter and project implementations were not sampled, so their internal wiring is not asserted.

Main entry points: [`code/chapter8/10_RAG_Pipeline_Complete.py`](https://github.com/daykalif/hello-agents/blob/main/code/chapter8/10_RAG_Pipeline_Complete.py) (Memory and RAG), [`code/chapter4/llm_client.py`](https://github.com/daykalif/hello-agents/blob/main/code/chapter4/llm_client.py) (Classic Patterns), [`Co-creation-projects/YYHDBL-HelloCodeAgentCli`](https://github.com/daykalif/hello-agents/tree/main/Co-creation-projects/YYHDBL-HelloCodeAgentCli) (Framework Construction), [`code/chapter11/06_complete_pipeline.py`](https://github.com/daykalif/hello-agents/blob/main/code/chapter11/06_complete_pipeline.py) (Agentic Training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Foundations"]
  node_agent_basics["Agent Basics"]
  node_agent_history["Agent History"]
  node_llm_fundamentals["LLM Fundamentals"]
end

subgraph group_building["Agent Building"]
  node_classic_patterns["Classic Patterns<br/>[llm_client.py]"]
  node_low_code_platforms["Low-Code Platforms"]
  node_agent_frameworks["Agent Frameworks"]
  node_framework_construction["Framework Construction"]
end

subgraph group_advanced["Advanced Systems"]
  node_memory_rag["Memory and RAG"]
  node_document_ingestion["Document Ingestion"]
  node_context_engineering["Context Engineering"]
  node_agent_protocols["Agent Protocols"]
  node_agentic_training["Agentic Training"]
  node_agent_evaluation["Agent Evaluation"]
end

subgraph group_applications["Applications"]
  node_travel_assistant["Travel Assistant"]
  node_deep_research["Deep Research"]
  node_cyber_town["Cyber Town"]
  node_graduation_project["Graduation Project"]
  node_interview_prep["Interview Prep"]
  node_agent_builder(("Agent Builder"))
end

node_learner(("Learner"))

node_learner -->|"studies"| node_agent_basics
node_agent_basics -->|"continues to"| node_agent_history
node_agent_history -->|"continues to"| node_llm_fundamentals
node_llm_fundamentals -->|"learns patterns"| node_classic_patterns
node_classic_patterns -->|"explores platforms"| node_low_code_platforms
node_low_code_platforms -->|"explores frameworks"| node_agent_frameworks
node_agent_frameworks -->|"builds framework"| node_framework_construction
node_framework_construction -->|"extends with memory"| node_memory_rag
node_memory_rag -->|"practices ingestion"| node_document_ingestion
node_memory_rag -->|"studies context"| node_context_engineering
node_context_engineering -->|"studies protocols"| node_agent_protocols
node_agent_protocols -->|"studies training"| node_agentic_training
node_agentic_training -->|"evaluates agents"| node_agent_evaluation
node_agent_evaluation -->|"applies learning"| node_travel_assistant
node_agent_evaluation -->|"applies learning"| node_deep_research
node_agent_evaluation -->|"applies learning"| node_cyber_town
node_travel_assistant -->|"informs project"| node_graduation_project
node_deep_research -->|"informs project"| node_graduation_project
node_cyber_town -->|"informs project"| node_graduation_project
node_learner -.->|"uses supplement"| node_interview_prep
node_graduation_project -->|"builds agent"| node_agent_builder

click node_classic_patterns "https://github.com/daykalif/hello-agents/blob/main/code/chapter4/llm_client.py"
click node_framework_construction "https://github.com/daykalif/hello-agents/tree/main/Co-creation-projects/YYHDBL-HelloCodeAgentCli"
click node_memory_rag "https://github.com/daykalif/hello-agents/blob/main/code/chapter8/10_RAG_Pipeline_Complete.py"
click node_document_ingestion "https://github.com/daykalif/hello-agents/blob/main/code/chapter8/04_RAGTool_MarkItDown_Pipeline.py"
click node_agentic_training "https://github.com/daykalif/hello-agents/blob/main/code/chapter11/06_complete_pipeline.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_agent_basics,node_agent_history,node_llm_fundamentals toneBlue
class node_classic_patterns,node_low_code_platforms,node_agent_frameworks,node_framework_construction toneAmber
class node_memory_rag,node_document_ingestion,node_context_engineering,node_agent_protocols,node_agentic_training,node_agent_evaluation toneMint
class node_travel_assistant,node_deep_research,node_cyber_town,node_graduation_project,node_interview_prep,node_agent_builder toneRose
class node_learner toneIndigo
```

## Components

### Foundations

- **Agent Basics**
- **Agent History**
- **LLM Fundamentals**

### Agent Building

- [Classic Patterns](https://github.com/daykalif/hello-agents/blob/main/code/chapter4/llm_client.py): `code/chapter4/llm_client.py`
- **Low-Code Platforms**
- **Agent Frameworks**
- [Framework Construction](https://github.com/daykalif/hello-agents/tree/main/Co-creation-projects/YYHDBL-HelloCodeAgentCli): `Co-creation-projects/YYHDBL-HelloCodeAgentCli`

### Advanced Systems

- [Memory and RAG](https://github.com/daykalif/hello-agents/blob/main/code/chapter8/10_RAG_Pipeline_Complete.py): `code/chapter8/10_RAG_Pipeline_Complete.py`
- [Document Ingestion](https://github.com/daykalif/hello-agents/blob/main/code/chapter8/04_RAGTool_MarkItDown_Pipeline.py): `code/chapter8/04_RAGTool_MarkItDown_Pipeline.py`
- **Context Engineering**
- **Agent Protocols**
- [Agentic Training](https://github.com/daykalif/hello-agents/blob/main/code/chapter11/06_complete_pipeline.py): `code/chapter11/06_complete_pipeline.py`
- **Agent Evaluation**

### Applications

- **Travel Assistant**
- **Deep Research**
- **Cyber Town**
- **Graduation Project**
- **Interview Prep**
- **Agent Builder**

### Other components

- **Learner**

## Connections

- Learner → Agent Basics: studies
- Agent Basics → Agent History: continues to
- Agent History → LLM Fundamentals: continues to
- LLM Fundamentals → Classic Patterns: learns patterns
- Classic Patterns → Low-Code Platforms: explores platforms
- Low-Code Platforms → Agent Frameworks: explores frameworks
- Agent Frameworks → Framework Construction: builds framework
- Framework Construction → Memory and RAG: extends with memory
- Memory and RAG → Document Ingestion: practices ingestion
- Memory and RAG → Context Engineering: studies context
- Context Engineering → Agent Protocols: studies protocols
- Agent Protocols → Agentic Training: studies training
- Agentic Training → Agent Evaluation: evaluates agents
- Agent Evaluation → Travel Assistant: applies learning
- Agent Evaluation → Deep Research: applies learning
- Agent Evaluation → Cyber Town: applies learning
- Travel Assistant → Graduation Project: informs project
- Deep Research → Graduation Project: informs project
- Cyber Town → Graduation Project: informs project
- Learner → Interview Prep: uses supplement
- Graduation Project → Agent Builder: builds agent