# shubhamsaboo/awesome-llm-apps architecture

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

- Interactive diagram: https://gitdiagram.com/shubhamsaboo/awesome-llm-apps
- Repository: https://github.com/shubhamsaboo/awesome-llm-apps

## Overview

Awesome LLM Apps is a catalog of independent AI agents, skills, and RAG applications—not one integrated runtime. A typical user chooses and runs a template; each app then follows its own path from input to generated result. The graph highlights major documented product areas and sampled implementations, including skill optimization, math and contextual RAG, MCP tools, travel planning, and podcast audio. The repository contains many additional templates not mapped here. Some relationships are documented or visible in excerpts; unsampled internals and cross-app connections are intentionally not inferred.

Main entry points: [`generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts`](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts) (MCP tool server), [`advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py`](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py) (TTS selector), [`agent_skills/self-improving-agent-skills/backend/app.py`](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/agent_skills/self-improving-agent-skills/backend/app.py) (Optimizer API), [`rag_tutorials/contextualai_rag_agent/contextualai_rag_agent.py`](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/contextualai_rag_agent/contextualai_rag_agent.py) (Contextual RAG app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Agent skills"]
  node_skill_app["Optimizer API<br/>[app.py]"]
  node_optimizer["ADK optimizer<br/>[adk_optimizer.py]"]
end

subgraph group_rag["RAG apps"]
  node_math_ui["Math tutor UI<br/>[streamlit.py]"]
  node_math_router["Math query routing<br/>[query_router.py]"]
  node_math_guards["Math guardrails<br/>[guardrails.py]"]
  node_contextual_app["Contextual RAG app"]
  node_contextual_service["Contextual AI"]
end

subgraph group_mcp["MCP apps"]
  node_mcp_server["MCP tool server<br/>[server.ts]"]
  node_flight_tools["Flight tools<br/>[flights.ts]"]
  node_hotel_tools["Hotel tools<br/>[hotels.ts]"]
  node_stock_tools["Stock tools<br/>[stocks.ts]"]
  node_board_tools["Kanban tools<br/>[kanban.ts]"]
end

subgraph group_travel["Travel planning"]
  node_travel_app["Travel planner<br/>[app.py]"]
  node_travel_services["Travel MCP services"]
end

subgraph group_podcast["Podcast generation"]
  node_tts_selector["TTS selector"]
  node_api_keys["API key loader<br/>[load_api_keys.py]"]
  node_eleven_tts["ElevenLabs audio"]
  node_kokoro_tts["Kokoro audio"]
  node_openai_tts["OpenAI audio"]
end

node_user(("App user"))

node_user -->|"uploads skill"| node_skill_app
node_skill_app -->|"invokes optimizer"| node_optimizer
node_user -.->|"asks question"| node_math_ui
node_math_router -->|"uses validators"| node_math_guards
node_user -->|"submits query"| node_contextual_app
node_contextual_app -->|"creates and queries"| node_contextual_service
node_mcp_server -->|"dispatches tools"| node_flight_tools
node_mcp_server -->|"dispatches tools"| node_hotel_tools
node_mcp_server -->|"dispatches tools"| node_stock_tools
node_mcp_server -->|"dispatches tools"| node_board_tools
node_user -->|"requests itinerary"| node_travel_app
node_travel_app -->|"connects MCP tools"| node_travel_services
node_tts_selector -->|"calls generator"| node_eleven_tts
node_tts_selector -->|"calls generator"| node_kokoro_tts
node_tts_selector -->|"calls generator"| node_openai_tts
node_tts_selector -->|"loads credentials"| node_api_keys

click node_skill_app "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/agent_skills/self-improving-agent-skills/backend/app.py"
click node_optimizer "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/agent_skills/self-improving-agent-skills/backend/adk_optimizer.py"
click node_math_ui "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/app/streamlit.py"
click node_math_router "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/rag/query_router.py"
click node_math_guards "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/rag/guardrails.py"
click node_contextual_app "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/contextualai_rag_agent/contextualai_rag_agent.py"
click node_mcp_server "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts"
click node_flight_tools "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/flights.ts"
click node_hotel_tools "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/hotels.ts"
click node_stock_tools "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/stocks.ts"
click node_board_tools "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/kanban.ts"
click node_travel_app "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py"
click node_tts_selector "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py"
click node_api_keys "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/load_api_keys.py"
click node_eleven_tts "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_elevenslab.py"
click node_kokoro_tts "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_kokoro.py"
click node_openai_tts "https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_openai.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_skill_app,node_optimizer,node_user toneBlue
class node_math_ui,node_math_router,node_math_guards,node_contextual_app,node_contextual_service toneAmber
class node_mcp_server,node_flight_tools,node_hotel_tools,node_stock_tools,node_board_tools toneMint
class node_travel_app,node_travel_services toneRose
class node_tts_selector,node_api_keys,node_eleven_tts,node_kokoro_tts,node_openai_tts toneIndigo
```

## Components

### Agent skills

- [Optimizer API](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/agent_skills/self-improving-agent-skills/backend/app.py): `agent_skills/self-improving-agent-skills/backend/app.py`
- [ADK optimizer](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/agent_skills/self-improving-agent-skills/backend/adk_optimizer.py): `agent_skills/self-improving-agent-skills/backend/adk_optimizer.py`

### RAG apps

- [Math tutor UI](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/app/streamlit.py): `rag_tutorials/agentic_rag_math_agent/app/streamlit.py`
- [Math query routing](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/rag/query_router.py): `rag_tutorials/agentic_rag_math_agent/rag/query_router.py`
- [Math guardrails](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/rag/guardrails.py): `rag_tutorials/agentic_rag_math_agent/rag/guardrails.py`
- [Contextual RAG app](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/rag_tutorials/contextualai_rag_agent/contextualai_rag_agent.py): `rag_tutorials/contextualai_rag_agent/contextualai_rag_agent.py`
- **Contextual AI**

### MCP apps

- [MCP tool server](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts): `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts`
- [Flight tools](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/flights.ts): `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/flights.ts`
- [Hotel tools](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/hotels.ts): `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/hotels.ts`
- [Stock tools](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/stocks.ts): `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/stocks.ts`
- [Kanban tools](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/kanban.ts): `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/src/kanban.ts`

### Travel planning

- [Travel planner](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py): `mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py`
- **Travel MCP services**

### Podcast generation

- [TTS selector](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py`
- [API key loader](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/load_api_keys.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/load_api_keys.py`
- [ElevenLabs audio](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_elevenslab.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_elevenslab.py`
- [Kokoro audio](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_kokoro.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_kokoro.py`
- [OpenAI audio](https://github.com/shubhamsaboo/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_openai.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/text_to_audio_openai.py`

### Other components

- **App user**

## Connections

- App user → Optimizer API: uploads skill (evidence: `agent_skills/self-improving-agent-skills/backend/app.py`)
- Optimizer API → ADK optimizer: invokes optimizer (evidence: `agent_skills/self-improving-agent-skills/backend/app.py`)
- App user → Math tutor UI: asks question
- Math query routing → Math guardrails: uses validators (evidence: `rag_tutorials/agentic_rag_math_agent/rag/query_router.py`)
- App user → Contextual RAG app: submits query (evidence: `rag_tutorials/contextualai_rag_agent/contextualai_rag_agent.py`)
- Contextual RAG app → Contextual AI: creates and queries (evidence: `rag_tutorials/contextualai_rag_agent/contextualai_rag_agent.py`)
- MCP tool server → Flight tools: dispatches tools (evidence: `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts`)
- MCP tool server → Hotel tools: dispatches tools (evidence: `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts`)
- MCP tool server → Stock tools: dispatches tools (evidence: `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts`)
- MCP tool server → Kanban tools: dispatches tools (evidence: `generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts`)
- App user → Travel planner: requests itinerary (evidence: `mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py`)
- Travel planner → Travel MCP services: connects MCP tools (evidence: `mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py`)
- TTS selector → ElevenLabs audio: calls generator (evidence: `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py`)
- TTS selector → Kokoro audio: calls generator (evidence: `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py`)
- TTS selector → OpenAI audio: calls generator (evidence: `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py`)
- TTS selector → API key loader: loads credentials (evidence: `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py`)
