# ashishpatel26/500-ai-agents-projects architecture

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

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

## Overview

This repository is a curated catalog of AI-agent examples, presented through a web atlas and accompanied by runnable agent scripts and a three-lesson CrewAI/MCP course. The user workflow is to browse the atlas or choose an example, inspect its details and code, then run a self-contained agent or follow a course lesson. The README documents broader framework and industry browsing capabilities. Sampled evidence supports the web entry point and catalog-data relationship; individual agent internals and most course lesson behavior were not inspected.

Main entry points: [`web/src/main.jsx`](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/main.jsx) (Web entry point), [`web/src/App.jsx`](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/App.jsx) (Atlas browsing UI), [`web/src/content.js`](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/content.js) (Catalog data builder), [`agents`](https://github.com/ashishpatel26/500-ai-agents-projects/tree/main/agents) (Agent catalog examples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_atlas["Web Atlas"]
  node_web_entry["Web entry point<br/>[main.jsx]"]
  node_atlas_ui["Atlas browsing UI<br/>[App.jsx]"]
  node_catalog_data["Catalog data builder<br/>[content.js]"]
end

subgraph group_examples["Runnable Agents"]
  node_web_catalog["Agent catalog examples"]
  node_web_research["Web research<br/>[agent.py]"]
  node_code_review["Code review<br/>[agent.py]"]
  node_pdf_qa["PDF question answering<br/>[agent.py]"]
  node_sql_agent["Natural language SQL<br/>[agent.py]"]
  node_email_drafting["Email drafting<br/>[agent.py]"]
  node_news_summary["News summarization<br/>[agent.py]"]
  node_issue_triage["GitHub issue triage<br/>[agent.py]"]
  node_data_analysis["Data analysis<br/>[agent.py]"]
  node_resume_parser["Resume parsing and fit<br/>[agent.py]"]
  node_meeting_notes["Meeting notes<br/>[agent.py]"]
  node_stock_research["Stock research<br/>[agent.py]"]
  node_travel_planner["Travel planning<br/>[agent.py]"]
  node_customer_support["Customer support<br/>[agent.py]"]
  node_social_media["Social media content<br/>[agent.py]"]
  node_test_generator["Unit test generation<br/>[agent.py]"]
  node_documentation_writer["Documentation writing<br/>[agent.py]"]
  node_recipe_agent["Recipe recommendations<br/>[agent.py]"]
  node_job_application["Job applications<br/>[agent.py]"]
  node_competitive_analysis["Competitive analysis<br/>[agent.py]"]
  node_debate_agent["Multi-agent debate<br/>[agent.py]"]
  node_pii_agent["PII sanitization<br/>[agent.py]"]
end

subgraph group_course["CrewAI Course"]
  node_lesson_one["CrewAI introduction<br/>[agent.py]"]
  node_lesson_two["Multi-agent tool use<br/>[agent.py]"]
  node_lesson_three["CrewAI and MCP<br/>[agent.py]"]
  node_mcp_server["Example MCP server<br/>[mcp_server.py]"]
end

node_visitor(("Developer or learner"))

node_visitor -->|"opens atlas"| node_web_entry
node_web_entry -->|"renders"| node_atlas_ui
node_atlas_ui -->|"uses catalog"| node_catalog_data
node_catalog_data -->|"discovers examples"| node_web_catalog
node_visitor -->|"runs an agent"| node_web_catalog
node_visitor -->|"follows course"| node_lesson_one
node_visitor -->|"follows course"| node_lesson_two
node_visitor -->|"follows course"| node_lesson_three

click node_web_entry "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/main.jsx"
click node_atlas_ui "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/App.jsx"
click node_catalog_data "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/content.js"
click node_web_catalog "https://github.com/ashishpatel26/500-ai-agents-projects/tree/main/agents"
click node_web_research "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/01-web-research-agent/agent.py"
click node_code_review "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/02-code-review-agent/agent.py"
click node_pdf_qa "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/03-pdf-qa-agent/agent.py"
click node_sql_agent "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/04-sql-query-agent/agent.py"
click node_email_drafting "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/05-email-drafting-agent/agent.py"
click node_news_summary "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/06-news-summarizer-agent/agent.py"
click node_issue_triage "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/07-github-issue-triager/agent.py"
click node_data_analysis "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/08-data-analysis-agent/agent.py"
click node_resume_parser "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/09-resume-parser-agent/agent.py"
click node_meeting_notes "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/10-meeting-notes-agent/agent.py"
click node_stock_research "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/11-stock-research-agent/agent.py"
click node_travel_planner "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/12-travel-planner-agent/agent.py"
click node_customer_support "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/13-customer-support-agent/agent.py"
click node_social_media "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/14-social-media-agent/agent.py"
click node_test_generator "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/15-unit-test-generator/agent.py"
click node_documentation_writer "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/16-documentation-writer/agent.py"
click node_recipe_agent "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/17-recipe-agent/agent.py"
click node_job_application "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/18-job-application-agent/agent.py"
click node_competitive_analysis "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/19-competitive-analysis-agent/agent.py"
click node_debate_agent "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/20-multi-agent-debate/agent.py"
click node_pii_agent "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/21-pii-sanitization-agent/agent.py"
click node_lesson_one "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_01/agent.py"
click node_lesson_two "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_02/agent.py"
click node_lesson_three "https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_03/agent.py"
click node_mcp_server "https://github.com/ashishpatel26/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_web_entry,node_atlas_ui,node_catalog_data toneBlue
class node_web_catalog,node_web_research,node_code_review,node_pdf_qa,node_sql_agent,node_email_drafting,node_news_summary,node_issue_triage,node_data_analysis,node_resume_parser,node_meeting_notes,node_stock_research,node_travel_planner,node_customer_support,node_social_media,node_test_generator,node_documentation_writer,node_recipe_agent,node_job_application,node_competitive_analysis,node_debate_agent,node_pii_agent toneAmber
class node_lesson_one,node_lesson_two,node_lesson_three,node_mcp_server toneMint
class node_visitor toneIndigo
```

## Components

### Web Atlas

- [Web entry point](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/main.jsx): `web/src/main.jsx`
- [Atlas browsing UI](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/App.jsx): `web/src/App.jsx`
- [Catalog data builder](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/web/src/content.js): `web/src/content.js`

### Runnable Agents

- [Agent catalog examples](https://github.com/ashishpatel26/500-ai-agents-projects/tree/main/agents): `agents`
- [Web research](https://github.com/ashishpatel26/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/ashishpatel26/500-ai-agents-projects/blob/main/agents/02-code-review-agent/agent.py): `agents/02-code-review-agent/agent.py`
- [PDF question answering](https://github.com/ashishpatel26/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/ashishpatel26/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/ashishpatel26/500-ai-agents-projects/blob/main/agents/05-email-drafting-agent/agent.py): `agents/05-email-drafting-agent/agent.py`
- [News summarization](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/06-news-summarizer-agent/agent.py): `agents/06-news-summarizer-agent/agent.py`
- [GitHub issue triage](https://github.com/ashishpatel26/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/ashishpatel26/500-ai-agents-projects/blob/main/agents/08-data-analysis-agent/agent.py): `agents/08-data-analysis-agent/agent.py`
- [Resume parsing and fit](https://github.com/ashishpatel26/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/ashishpatel26/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/ashishpatel26/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/ashishpatel26/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/ashishpatel26/500-ai-agents-projects/blob/main/agents/13-customer-support-agent/agent.py): `agents/13-customer-support-agent/agent.py`
- [Social media content](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/14-social-media-agent/agent.py): `agents/14-social-media-agent/agent.py`
- [Unit test generation](https://github.com/ashishpatel26/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/ashishpatel26/500-ai-agents-projects/blob/main/agents/16-documentation-writer/agent.py): `agents/16-documentation-writer/agent.py`
- [Recipe recommendations](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/agents/17-recipe-agent/agent.py): `agents/17-recipe-agent/agent.py`
- [Job applications](https://github.com/ashishpatel26/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/ashishpatel26/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/ashishpatel26/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/ashishpatel26/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/ashishpatel26/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_01/agent.py): `crewai_mcp_course/lesson_01/agent.py`
- [Multi-agent tool use](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_02/agent.py): `crewai_mcp_course/lesson_02/agent.py`
- [CrewAI and MCP](https://github.com/ashishpatel26/500-ai-agents-projects/blob/main/crewai_mcp_course/lesson_03/agent.py): `crewai_mcp_course/lesson_03/agent.py`
- [Example MCP server](https://github.com/ashishpatel26/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**

## Connections

- Developer or learner → Web entry point: opens atlas (evidence: `README.md`)
- Web entry point → Atlas browsing UI: renders (evidence: `web/src/main.jsx`)
- Atlas browsing UI → Catalog data builder: uses catalog (evidence: `web/src/App.jsx`)
- Catalog data builder → Agent catalog examples: discovers examples (evidence: `web/src/content.js`)
- Developer or learner → Agent catalog examples: runs an agent (evidence: `README.md`)
- Developer or learner → CrewAI introduction: follows course (evidence: `README.md`)
- Developer or learner → Multi-agent tool use: follows course (evidence: `README.md`)
- Developer or learner → CrewAI and MCP: follows course (evidence: `README.md`)
