# onkar-borwar/500-ai-agents-projects architecture

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

- Interactive diagram: https://gitdiagram.com/onkar-borwar/500-ai-agents-projects
- Repository: https://github.com/onkar-borwar/500-ai-agents-projects

## Overview

This repository is a curated catalog of runnable AI-agent examples, accompanied by a React atlas for browsing them and a small CrewAI/MCP learning course. The main user workflow is to browse the atlas or choose an example, run its standalone agent, and receive a task-specific result. The README documents the collection’s broader framework and industry coverage; the graph focuses on the examples present in the supplied tree. Agent internals were not sampled, so their task-specific behavior is represented without inferred call chains.

Main entry points: [`web/src/App.jsx`](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/web/src/App.jsx) (Atlas interface), [`agents/04-sql-query-agent/agent.py`](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/04-sql-query-agent/agent.py) (Natural-language SQL), [`crewai_mcp_course/lesson_03/agent.py`](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_03/agent.py) (MCP integration), [`web/src/content.js`](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/web/src/content.js) (Catalog data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_atlas["Agent Atlas"]
  node_app["Atlas interface<br/>[App.jsx]"]
  node_catalog["Catalog data<br/>[content.js]"]
end

subgraph group_agents["Runnable Agents"]
  node_research["Web research<br/>[agent.py]"]
  node_review["Code review<br/>[agent.py]"]
  node_pdfqa["PDF Q&amp;A<br/>[agent.py]"]
  node_sql["Natural-language SQL<br/>[agent.py]"]
  node_email["Email drafting<br/>[agent.py]"]
  node_news["News summary<br/>[agent.py]"]
  node_triage["Issue triage<br/>[agent.py]"]
  node_analysis["Data analysis<br/>[agent.py]"]
  node_resume["Resume parsing<br/>[agent.py]"]
  node_meeting["Meeting notes<br/>[agent.py]"]
  node_stock["Stock research<br/>[agent.py]"]
  node_travel["Travel planning<br/>[agent.py]"]
  node_support["Customer support<br/>[agent.py]"]
  node_social["Social media<br/>[agent.py]"]
  node_tests["Test generation<br/>[agent.py]"]
  node_docs["Documentation writing<br/>[agent.py]"]
  node_recipe["Recipe recommendations<br/>[agent.py]"]
  node_job["Job applications<br/>[agent.py]"]
  node_competitive["Competitive analysis<br/>[agent.py]"]
  node_debate["Multi-agent debate<br/>[agent.py]"]
  node_pii["PII sanitization<br/>[agent.py]"]
end

subgraph group_course["CrewAI Course"]
  node_lesson1["CrewAI introduction<br/>[agent.py]"]
  node_lesson2["Multi-agent crew<br/>[agent.py]"]
  node_lesson3["MCP integration<br/>[agent.py]"]
  node_mcpserver["MCP tool server<br/>[mcp_server.py]"]
end

node_visitor(("Developer or learner"))
node_llm(("LLM provider"))
node_sqlite[("SQLite database")]

node_visitor -->|"browses"| node_app
node_app -->|"uses catalog"| node_catalog
node_visitor -->|"runs example"| node_research
node_visitor -->|"runs example"| node_review
node_visitor -->|"runs example"| node_pdfqa
node_visitor -->|"runs example"| node_sql
node_visitor -->|"runs example"| node_email
node_visitor -->|"runs example"| node_news
node_visitor -->|"runs example"| node_triage
node_visitor -->|"runs example"| node_analysis
node_visitor -->|"runs example"| node_resume
node_visitor -->|"runs example"| node_meeting
node_visitor -->|"runs example"| node_stock
node_visitor -->|"runs example"| node_travel
node_visitor -->|"runs example"| node_support
node_visitor -->|"runs example"| node_social
node_visitor -->|"runs example"| node_tests
node_visitor -->|"runs example"| node_docs
node_visitor -->|"runs example"| node_recipe
node_visitor -->|"runs example"| node_job
node_visitor -->|"runs example"| node_competitive
node_visitor -->|"runs example"| node_debate
node_visitor -->|"runs example"| node_pii
node_visitor -.->|"studies lessons"| node_visitor
node_visitor -.->|"requests model output"| node_llm
node_sql -->|"queries"| node_sqlite
node_visitor -->|"runs lesson"| node_lesson1
node_visitor -->|"runs lesson"| node_lesson2
node_visitor -->|"runs lesson"| node_lesson3
node_lesson3 -.->|"mirrors contracts"| node_mcpserver

click node_app "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/web/src/App.jsx"
click node_catalog "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/web/src/content.js"
click node_research "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/01-web-research-agent/agent.py"
click node_review "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/02-code-review-agent/agent.py"
click node_pdfqa "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/03-pdf-qa-agent/agent.py"
click node_sql "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/04-sql-query-agent/agent.py"
click node_email "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/05-email-drafting-agent/agent.py"
click node_news "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/06-news-summarizer-agent/agent.py"
click node_triage "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/07-github-issue-triager/agent.py"
click node_analysis "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/08-data-analysis-agent/agent.py"
click node_resume "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/09-resume-parser-agent/agent.py"
click node_meeting "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/10-meeting-notes-agent/agent.py"
click node_stock "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/11-stock-research-agent/agent.py"
click node_travel "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/12-travel-planner-agent/agent.py"
click node_support "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/13-customer-support-agent/agent.py"
click node_social "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/14-social-media-agent/agent.py"
click node_tests "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/15-unit-test-generator/agent.py"
click node_docs "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/16-documentation-writer/agent.py"
click node_recipe "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/17-recipe-agent/agent.py"
click node_job "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/18-job-application-agent/agent.py"
click node_competitive "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/19-competitive-analysis-agent/agent.py"
click node_debate "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/20-multi-agent-debate/agent.py"
click node_pii "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/21-pii-sanitization-agent/agent.py"
click node_lesson1 "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_01/agent.py"
click node_lesson2 "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_02/agent.py"
click node_lesson3 "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_03/agent.py"
click node_mcpserver "https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_03/mcp_server.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_app,node_catalog toneBlue
class node_research,node_review,node_pdfqa,node_sql,node_email,node_news,node_triage,node_analysis,node_resume,node_meeting,node_stock,node_travel,node_support,node_social,node_tests,node_docs,node_recipe,node_job,node_competitive,node_debate,node_pii,node_sqlite toneAmber
class node_lesson1,node_lesson2,node_lesson3,node_mcpserver toneMint
class node_visitor,node_llm toneIndigo
```

## Components

### Agent Atlas

- [Atlas interface](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/web/src/App.jsx): `web/src/App.jsx`
- [Catalog data](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/web/src/content.js): `web/src/content.js`

### Runnable Agents

- [Web research](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/01-web-research-agent/agent.py): `agents/01-web-research-agent/agent.py`
- [Code review](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/02-code-review-agent/agent.py): `agents/02-code-review-agent/agent.py`
- [PDF Q&A](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/03-pdf-qa-agent/agent.py): `agents/03-pdf-qa-agent/agent.py`
- [Natural-language SQL](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/04-sql-query-agent/agent.py): `agents/04-sql-query-agent/agent.py`
- [Email drafting](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/05-email-drafting-agent/agent.py): `agents/05-email-drafting-agent/agent.py`
- [News summary](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/06-news-summarizer-agent/agent.py): `agents/06-news-summarizer-agent/agent.py`
- [Issue triage](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/07-github-issue-triager/agent.py): `agents/07-github-issue-triager/agent.py`
- [Data analysis](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/08-data-analysis-agent/agent.py): `agents/08-data-analysis-agent/agent.py`
- [Resume parsing](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/09-resume-parser-agent/agent.py): `agents/09-resume-parser-agent/agent.py`
- [Meeting notes](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/10-meeting-notes-agent/agent.py): `agents/10-meeting-notes-agent/agent.py`
- [Stock research](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/11-stock-research-agent/agent.py): `agents/11-stock-research-agent/agent.py`
- [Travel planning](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/12-travel-planner-agent/agent.py): `agents/12-travel-planner-agent/agent.py`
- [Customer support](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/13-customer-support-agent/agent.py): `agents/13-customer-support-agent/agent.py`
- [Social media](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/14-social-media-agent/agent.py): `agents/14-social-media-agent/agent.py`
- [Test generation](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/15-unit-test-generator/agent.py): `agents/15-unit-test-generator/agent.py`
- [Documentation writing](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/16-documentation-writer/agent.py): `agents/16-documentation-writer/agent.py`
- [Recipe recommendations](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/17-recipe-agent/agent.py): `agents/17-recipe-agent/agent.py`
- [Job applications](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/18-job-application-agent/agent.py): `agents/18-job-application-agent/agent.py`
- [Competitive analysis](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/19-competitive-analysis-agent/agent.py): `agents/19-competitive-analysis-agent/agent.py`
- [Multi-agent debate](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/20-multi-agent-debate/agent.py): `agents/20-multi-agent-debate/agent.py`
- [PII sanitization](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/agents/21-pii-sanitization-agent/agent.py): `agents/21-pii-sanitization-agent/agent.py`

### CrewAI Course

- [CrewAI introduction](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_01/agent.py): `crewai_mcp_course/lesson_01/agent.py`
- [Multi-agent crew](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_02/agent.py): `crewai_mcp_course/lesson_02/agent.py`
- [MCP integration](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_03/agent.py): `crewai_mcp_course/lesson_03/agent.py`
- [MCP tool server](https://github.com/onkar-borwar/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_03/mcp_server.py): `crewai_mcp_course/lesson_03/mcp_server.py`

### Other components

- **Developer or learner**
- **LLM provider**
- **SQLite database**

## Connections

- Developer or learner → Atlas interface: browses (evidence: `web/src/App.jsx`)
- Atlas interface → Catalog data: uses catalog (evidence: `web/src/App.jsx`)
- Developer or learner → Web research: runs example (evidence: `README.md`)
- Developer or learner → Code review: runs example (evidence: `README.md`)
- Developer or learner → PDF Q&A: runs example (evidence: `README.md`)
- Developer or learner → Natural-language SQL: runs example (evidence: `README.md`)
- Developer or learner → Email drafting: runs example (evidence: `README.md`)
- Developer or learner → News summary: runs example (evidence: `README.md`)
- Developer or learner → Issue triage: runs example (evidence: `README.md`)
- Developer or learner → Data analysis: runs example (evidence: `README.md`)
- Developer or learner → Resume parsing: runs example (evidence: `README.md`)
- Developer or learner → Meeting notes: runs example (evidence: `README.md`)
- Developer or learner → Stock research: runs example (evidence: `README.md`)
- Developer or learner → Travel planning: runs example (evidence: `README.md`)
- Developer or learner → Customer support: runs example (evidence: `README.md`)
- Developer or learner → Social media: runs example (evidence: `README.md`)
- Developer or learner → Test generation: runs example (evidence: `README.md`)
- Developer or learner → Documentation writing: runs example (evidence: `README.md`)
- Developer or learner → Recipe recommendations: runs example (evidence: `README.md`)
- Developer or learner → Job applications: runs example (evidence: `README.md`)
- Developer or learner → Competitive analysis: runs example (evidence: `README.md`)
- Developer or learner → Multi-agent debate: runs example (evidence: `README.md`)
- Developer or learner → PII sanitization: runs example (evidence: `README.md`)
- Developer or learner → Developer or learner: studies lessons (evidence: `README.md`)
- Developer or learner → LLM provider: requests model output
- Natural-language SQL → SQLite database: queries (evidence: `agents/04-sql-query-agent/agent.py`)
- Developer or learner → CrewAI introduction: runs lesson (evidence: `README.md`)
- Developer or learner → Multi-agent crew: runs lesson (evidence: `README.md`)
- Developer or learner → MCP integration: runs lesson (evidence: `README.md`)
- MCP integration → MCP tool server: mirrors contracts (evidence: `crewai_mcp_course/lesson_03/agent.py`)
