# alirezadir/agentic-ai-systems architecture

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

- Interactive diagram: https://gitdiagram.com/alirezadir/agentic-ai-systems
- Repository: https://github.com/alirezadir/agentic-ai-systems

## Overview

This repository is a curated learning guide and collection of runnable agent examples, not one deployed application. A learner’s broad workflow is to explore framework and system-design material, then run a selected example to produce a response, report, or retrieval result. The graph preserves major documented topic branches and shows several concrete use-case flows whose calls are visible in the sampled source. Many listed examples were not inspected, so their internal relationships are intentionally omitted.

Main entry points: [`02_frameworks`](https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks) (Framework guides), [`04_use_cases/legal-doc-assistant/src/api/main.py`](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/api/main.py) (Legal document API), [`04_use_cases/research_agents/financial_research_multi_agent/manager.py`](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/manager.py) (Financial research), [`02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py`](https://github.com/alirezadir/agentic-ai-systems/blob/main/02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py) (CrewAI starter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frameworks["Agent frameworks"]
  node_framework_guides["Framework guides"]
  node_openai_examples["OpenAI agents"]
  node_langchain_rag["LangChain RAG"]
  node_langgraph_examples["LangGraph examples"]
  node_llamaindex_examples["LlamaIndex examples"]
  node_crewai_runner["CrewAI starter<br/>[main.py]"]
  node_crewai_crew["Research crew<br/>[crew.py]"]
end

subgraph group_design["System design"]
  node_design_patterns["Agent patterns"]
  node_rag_design["RAG patterns"]
  node_protocols["MCP examples"]
end

subgraph group_usecases["Applied assistants"]
  node_legal_api["Legal document API<br/>[main.py]"]
  node_document_processing["PDF processing"]
  node_vector_store[("Vector retrieval<br/>[vector_store.py]")]
  node_rag_chain["Answer generation<br/>[rag_chain.py]"]
  node_weather_ui["Weather chat UI<br/>[app.py]"]
  node_weather_agent["Weather agent<br/>[weather_agent.py]"]
  node_airline_support["Airline support<br/>[main.py]"]
end

subgraph group_research["Research workflows"]
  node_financial_manager["Financial research<br/>[manager.py]"]
  node_planner["Search planner<br/>[planner_agent.py]"]
  node_searcher["Search agent<br/>[search_agent.py]"]
  node_report_writer["Report writer<br/>[writer_agent.py]"]
  node_verifier["Report verifier<br/>[verifier_agent.py]"]
end

node_learner(("Learner"))

node_learner -.->|"explores"| node_framework_guides
node_framework_guides -.->|"offers examples"| node_openai_examples
node_framework_guides -.->|"offers examples"| node_langchain_rag
node_framework_guides -.->|"offers examples"| node_langgraph_examples
node_framework_guides -.->|"offers examples"| node_llamaindex_examples
node_learner -->|"runs"| node_crewai_runner
node_crewai_runner -->|"starts"| node_crewai_crew
node_learner -.->|"studies"| node_design_patterns
node_learner -.->|"studies"| node_rag_design
node_learner -.->|"explores"| node_protocols
node_legal_api -->|"processes upload"| node_document_processing
node_legal_api -->|"adds documents"| node_vector_store
node_legal_api -->|"retrieves matches"| node_vector_store
node_legal_api -->|"requests answer"| node_rag_chain
node_weather_ui -->|"submits query"| node_weather_agent
node_financial_manager -->|"plans searches"| node_planner
node_financial_manager -->|"runs searches"| node_searcher
node_financial_manager -->|"writes report"| node_report_writer
node_financial_manager -->|"verifies report"| node_verifier
node_learner -.->|"runs example"| node_airline_support

click node_framework_guides "https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks"
click node_openai_examples "https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/1_openai/code"
click node_langchain_rag "https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/2_langchain/code/RAG"
click node_langgraph_examples "https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/3_langgraph/code"
click node_llamaindex_examples "https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/4_llamaindex/code"
click node_crewai_runner "https://github.com/alirezadir/agentic-ai-systems/blob/main/02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py"
click node_crewai_crew "https://github.com/alirezadir/agentic-ai-systems/blob/main/02_frameworks/5_crewai/code/starter_project/src/starter_project/crew.py"
click node_design_patterns "https://github.com/alirezadir/agentic-ai-systems/tree/main/03_system_design/design-patterns/code"
click node_rag_design "https://github.com/alirezadir/agentic-ai-systems/tree/main/03_system_design/RAGs/code"
click node_protocols "https://github.com/alirezadir/agentic-ai-systems/tree/main/03_system_design/protocols"
click node_legal_api "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/api/main.py"
click node_document_processing "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/data/document_processor.py"
click node_vector_store "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/data/vector_store.py"
click node_rag_chain "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/models/rag_chain.py"
click node_weather_ui "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/weather_agent_app/app.py"
click node_weather_agent "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/weather_agent_app/weather_agent.py"
click node_financial_manager "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/manager.py"
click node_planner "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/planner_agent.py"
click node_searcher "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/search_agent.py"
click node_report_writer "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/writer_agent.py"
click node_verifier "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/verifier_agent.py"
click node_airline_support "https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/customer_support_agents/02_customer_support_flights/main.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_framework_guides,node_openai_examples,node_langchain_rag,node_langgraph_examples,node_llamaindex_examples,node_crewai_runner,node_crewai_crew toneBlue
class node_design_patterns,node_rag_design,node_protocols toneAmber
class node_legal_api,node_document_processing,node_vector_store,node_rag_chain,node_weather_ui,node_weather_agent,node_airline_support toneMint
class node_financial_manager,node_planner,node_searcher,node_report_writer,node_verifier toneRose
class node_learner toneIndigo
```

## Components

### Agent frameworks

- [Framework guides](https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks): `02_frameworks`
- [OpenAI agents](https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/1_openai/code): `02_frameworks/1_openai/code`
- [LangChain RAG](https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/2_langchain/code/RAG): `02_frameworks/2_langchain/code/RAG`
- [LangGraph examples](https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/3_langgraph/code): `02_frameworks/3_langgraph/code`
- [LlamaIndex examples](https://github.com/alirezadir/agentic-ai-systems/tree/main/02_frameworks/4_llamaindex/code): `02_frameworks/4_llamaindex/code`
- [CrewAI starter](https://github.com/alirezadir/agentic-ai-systems/blob/main/02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py): `02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py`
- [Research crew](https://github.com/alirezadir/agentic-ai-systems/blob/main/02_frameworks/5_crewai/code/starter_project/src/starter_project/crew.py): `02_frameworks/5_crewai/code/starter_project/src/starter_project/crew.py`

### System design

- [Agent patterns](https://github.com/alirezadir/agentic-ai-systems/tree/main/03_system_design/design-patterns/code): `03_system_design/design-patterns/code`
- [RAG patterns](https://github.com/alirezadir/agentic-ai-systems/tree/main/03_system_design/RAGs/code): `03_system_design/RAGs/code`
- [MCP examples](https://github.com/alirezadir/agentic-ai-systems/tree/main/03_system_design/protocols): `03_system_design/protocols`

### Applied assistants

- [Legal document API](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/api/main.py): `04_use_cases/legal-doc-assistant/src/api/main.py`
- [PDF processing](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/data/document_processor.py): `04_use_cases/legal-doc-assistant/src/data/document_processor.py`
- [Vector retrieval](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/data/vector_store.py): `04_use_cases/legal-doc-assistant/src/data/vector_store.py`
- [Answer generation](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/legal-doc-assistant/src/models/rag_chain.py): `04_use_cases/legal-doc-assistant/src/models/rag_chain.py`
- [Weather chat UI](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/weather_agent_app/app.py): `04_use_cases/weather_agent_app/app.py`
- [Weather agent](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/weather_agent_app/weather_agent.py): `04_use_cases/weather_agent_app/weather_agent.py`
- [Airline support](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/customer_support_agents/02_customer_support_flights/main.py): `04_use_cases/customer_support_agents/02_customer_support_flights/main.py`

### Research workflows

- [Financial research](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/manager.py): `04_use_cases/research_agents/financial_research_multi_agent/manager.py`
- [Search planner](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/planner_agent.py): `04_use_cases/research_agents/financial_research_multi_agent/agents/planner_agent.py`
- [Search agent](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/search_agent.py): `04_use_cases/research_agents/financial_research_multi_agent/agents/search_agent.py`
- [Report writer](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/writer_agent.py): `04_use_cases/research_agents/financial_research_multi_agent/agents/writer_agent.py`
- [Report verifier](https://github.com/alirezadir/agentic-ai-systems/blob/main/04_use_cases/research_agents/financial_research_multi_agent/agents/verifier_agent.py): `04_use_cases/research_agents/financial_research_multi_agent/agents/verifier_agent.py`

### Other components

- **Learner**

## Connections

- Learner → Framework guides: explores
- Framework guides → OpenAI agents: offers examples (evidence: `02_frameworks/1_openai/code/11_mcp/filesystem/main.py`)
- Framework guides → LangChain RAG: offers examples
- Framework guides → LangGraph examples: offers examples
- Framework guides → LlamaIndex examples: offers examples
- Learner → CrewAI starter: runs (evidence: `02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py`)
- CrewAI starter → Research crew: starts (evidence: `02_frameworks/5_crewai/code/starter_project/src/starter_project/main.py`)
- Learner → Agent patterns: studies
- Learner → RAG patterns: studies
- Learner → MCP examples: explores
- Legal document API → PDF processing: processes upload (evidence: `04_use_cases/legal-doc-assistant/src/api/main.py`)
- Legal document API → Vector retrieval: adds documents (evidence: `04_use_cases/legal-doc-assistant/src/api/main.py`)
- Legal document API → Vector retrieval: retrieves matches (evidence: `04_use_cases/legal-doc-assistant/src/api/main.py`)
- Legal document API → Answer generation: requests answer (evidence: `04_use_cases/legal-doc-assistant/src/api/main.py`)
- Weather chat UI → Weather agent: submits query (evidence: `04_use_cases/weather_agent_app/app.py`)
- Financial research → Search planner: plans searches (evidence: `04_use_cases/research_agents/financial_research_multi_agent/manager.py`)
- Financial research → Search agent: runs searches (evidence: `04_use_cases/research_agents/financial_research_multi_agent/manager.py`)
- Financial research → Report writer: writes report (evidence: `04_use_cases/research_agents/financial_research_multi_agent/manager.py`)
- Financial research → Report verifier: verifies report (evidence: `04_use_cases/research_agents/financial_research_multi_agent/manager.py`)
- Learner → Airline support: runs example
