# nalini-krishna/awesome-llm-apps architecture

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

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

## Overview

Awesome LLM Apps is a catalog of independent AI applications and agent templates, not one integrated runtime. Its principal user journey varies by app: users provide a task or inputs, an app routes work through an agent or tools, and it returns a result such as an answer, itinerary, or podcast. The tree and excerpts support several representative workflows, plus the repository’s broader agent, RAG, voice, and MCP categories; they do not establish wiring between separate projects.

Main entry points: [`generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts`](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts) (Showcase MCP server), [`rag_tutorials/agentic_rag_math_agent/rag/query_router.py`](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/rag/query_router.py) (Math Q&A), [`generative_ui_agents/ai-mcp-app-builder/apps/web/app/api/mastra-agent/route.ts`](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/ai-mcp-app-builder/apps/web/app/api/mastra-agent/route.ts) (MCP app client), [`mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py`](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py) (Planner interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rag["RAG apps"]
  node_mathapp["Math Q&amp;A<br/>[query_router.py]"]
  node_mathkb[("Math knowledge base")]
  node_dbrag["Database routing RAG"]
end

subgraph group_travel["Travel planners"]
  node_travelui["Planner interface<br/>[app.py]"]
  node_travelagent["Travel planning agent<br/>[app.py]"]
  node_mcpservices["Travel MCP services<br/>[app.py]"]
end

subgraph group_podcast["News and podcast"]
  node_beifongapi["Podcast API<br/>[main.py]"]
  node_podcaststate[("Session state")]
  node_podcasttools["Podcast generation"]
  node_podcastdb[("Podcast records")]
end

subgraph group_mcp["MCP apps"]
  node_mcpclient["MCP app client<br/>[route.ts]"]
  node_servermanager["Server manager"]
  node_mcpserver["Showcase MCP server<br/>[server.ts]"]
  node_flighttools["Flight tools<br/>[server.ts]"]
  node_hoteltools["Hotel tools<br/>[server.ts]"]
  node_stocktools["Portfolio tools<br/>[server.ts]"]
  node_kanban["Kanban tools<br/>[server.ts]"]
end

node_user(("App user"))
node_websearch["Web search"]
node_llm["LLM provider"]

node_user -->|"asks"| node_mathapp
node_mathapp -->|"retrieves"| node_mathkb
node_mathapp -.->|"falls back"| node_websearch
node_mathapp -->|"explains"| node_llm
node_user -->|"asks"| node_dbrag
node_user -->|"enters trip"| node_travelui
node_travelui -->|"runs"| node_travelagent
node_travelagent -->|"uses tools"| node_mcpservices
node_user -->|"requests podcast"| node_beifongapi
node_beifongapi -->|"reads and writes"| node_podcaststate
node_podcasttools -->|"saves podcast"| node_podcastdb
node_user -->|"configures servers"| node_servermanager
node_servermanager -->|"syncs server list"| node_mcpclient
node_user -->|"uses app"| node_mcpclient
node_mcpclient -->|"dispatches tools"| node_mcpserver
node_mcpserver -->|"calls"| node_flighttools
node_mcpserver -->|"calls"| node_hoteltools
node_mcpserver -->|"calls"| node_stocktools
node_mcpserver -->|"calls"| node_kanban

click node_mathapp "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/rag_tutorials/agentic_rag_math_agent/rag/query_router.py"
click node_dbrag "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/rag_tutorials/rag_database_routing/rag_database_routing.py"
click node_travelui "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py"
click node_travelagent "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py"
click node_mcpservices "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/mcp_ai_agents/ai_travel_planner_mcp_agent_team/app.py"
click node_beifongapi "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/main.py"
click node_podcaststate "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/services/internal_session_service.py"
click node_podcasttools "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/utils/tts_engine_selector.py"
click node_podcastdb "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/tools/session_state_manager.py"
click node_mcpclient "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/ai-mcp-app-builder/apps/web/app/api/mastra-agent/route.ts"
click node_servermanager "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/ai-mcp-app-builder/apps/web/app/components/McpServerManager.tsx"
click node_mcpserver "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts"
click node_flighttools "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts"
click node_hoteltools "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts"
click node_stocktools "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts"
click node_kanban "https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/mcp-apps-generative-ui-showcase/mcp-server/server.ts"

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_mathapp,node_mathkb,node_dbrag,node_user toneBlue
class node_travelui,node_travelagent,node_mcpservices toneAmber
class node_beifongapi,node_podcaststate,node_podcasttools,node_podcastdb toneMint
class node_mcpclient,node_servermanager,node_mcpserver,node_flighttools,node_hoteltools,node_stocktools,node_kanban toneRose
class node_websearch,node_llm toneIndigo
```

## Components

### RAG apps

- [Math Q&A](https://github.com/nalini-krishna/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 knowledge base**
- [Database routing RAG](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/rag_tutorials/rag_database_routing/rag_database_routing.py): `rag_tutorials/rag_database_routing/rag_database_routing.py`

### Travel planners

- [Planner interface](https://github.com/nalini-krishna/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 planning agent](https://github.com/nalini-krishna/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](https://github.com/nalini-krishna/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`

### News and podcast

- [Podcast API](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/main.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/main.py`
- [Session state](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/services/internal_session_service.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/services/internal_session_service.py`
- [Podcast generation](https://github.com/nalini-krishna/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`
- [Podcast records](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/tools/session_state_manager.py): `advanced_ai_agents/multi_agent_apps/ai_news_and_podcast_agents/beifong/tools/session_state_manager.py`

### MCP apps

- [MCP app client](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/ai-mcp-app-builder/apps/web/app/api/mastra-agent/route.ts): `generative_ui_agents/ai-mcp-app-builder/apps/web/app/api/mastra-agent/route.ts`
- [Server manager](https://github.com/nalini-krishna/awesome-llm-apps/blob/main/generative_ui_agents/ai-mcp-app-builder/apps/web/app/components/McpServerManager.tsx): `generative_ui_agents/ai-mcp-app-builder/apps/web/app/components/McpServerManager.tsx`
- [Showcase MCP server](https://github.com/nalini-krishna/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/nalini-krishna/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`
- [Hotel tools](https://github.com/nalini-krishna/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`
- [Portfolio tools](https://github.com/nalini-krishna/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`
- [Kanban tools](https://github.com/nalini-krishna/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`

### Other components

- **App user**
- **Web search**
- **LLM provider**

## Connections

- App user → Math Q&A: asks
- Math Q&A → Math knowledge base: retrieves
- Math Q&A → Web search: falls back
- Math Q&A → LLM provider: explains
- App user → Database routing RAG: asks
- App user → Planner interface: enters trip
- Planner interface → Travel planning agent: runs
- Travel planning agent → Travel MCP services: uses tools
- App user → Podcast API: requests podcast
- Podcast API → Session state: reads and writes
- Podcast generation → Podcast records: saves podcast
- App user → Server manager: configures servers
- Server manager → MCP app client: syncs server list
- App user → MCP app client: uses app
- MCP app client → Showcase MCP server: dispatches tools
- Showcase MCP server → Flight tools: calls
- Showcase MCP server → Hotel tools: calls
- Showcase MCP server → Portfolio tools: calls
- Showcase MCP server → Kanban tools: calls