# sumeet6288/botsmith15012026 architecture

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

- Interactive diagram: https://gitdiagram.com/sumeet6288/botsmith15012026
- Repository: https://github.com/sumeet6288/botsmith15012026

## Overview

BotSmith is an AI agent/chatbot builder with a React interface and FastAPI backend. A principal workflow is configuring an agent, adding file, website, or text knowledge, and serving conversations through a dashboard preview, public chat, or embedded widget. The README also documents multi-provider AI, RAG, analytics, and messaging integrations. The graph reflects documented capabilities and indexed imports; several router and service implementations were not excerpted, so their internal call relationships are left out.

Main entry points: [`backend/server.py`](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/server.py) (API server), [`backend/services/discord_bot_manager.py`](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/discord_bot_manager.py) (Discord bot manager), [`backend/tasks.py`](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/tasks.py) (Background tasks), [`backend/services/chat_service.py`](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/chat_service.py) (Conversation service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experiences"]
  node_builder["Agent builder<br/>[ChatbotBuilder.jsx]"]
  node_preview["Chat preview"]
  node_publicchat["Public chat<br/>[PublicChat.jsx]"]
  node_widget["Embed widget<br/>[embed.js]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_router["App routing<br/>[App.js]"]
end

subgraph group_api["API and accounts"]
  node_api_server["API server<br/>[server.py]"]
  node_auth_routes["Authentication routes<br/>[auth_router.py]"]
  node_auth["Token and auth<br/>[auth.py]"]
  node_user_routes["User management<br/>[user_router.py]"]
  node_models["Domain models<br/>[models.py]"]
  node_mongo[("MongoDB")]
end

subgraph group_knowledge["Agent and knowledge"]
  node_chat_route["Chat routes<br/>[chat.py]"]
  node_chat_service["Conversation service<br/>[chat_service.py]"]
  node_agent_runtime["Agent runtime<br/>[runtime.py]"]
  node_sources["Source routes<br/>[sources.py]"]
  node_ingestion["Document processing"]
  node_chunking["Chunking"]
  node_rag["RAG retrieval<br/>[rag_service.py]"]
  node_vector[("Text vector store<br/>[vector_store.py]")]
  node_scraper["Website scraping<br/>[website_scraper.py]"]
end

subgraph group_operations["Integrations and operations"]
  node_tasks["Background tasks<br/>[tasks.py]"]
  node_analytics["Analytics routes<br/>[analytics.py]"]
  node_integrations["Integration routes<br/>[integrations.py]"]
  node_discord["Discord integration<br/>[discord.py]"]
  node_discord_manager["Discord bot manager"]
  node_plans["Plans and limits<br/>[plan_service.py]"]
  node_cache["Cache service<br/>[cache_service.py]"]
end

node_visitor(("Visitor"))
node_ai_providers(("AI providers"))
node_messaging(("Messaging platforms"))

node_visitor -->|"opens app"| node_router
node_router -->|"routes to"| node_builder
node_router -->|"routes to"| node_publicchat
node_builder -.->|"previews agent"| node_preview
node_preview -.->|"sends messages"| node_chat_route
node_visitor -.->|"opens widget"| node_widget
node_widget -.->|"requests chat"| node_chat_route
node_dashboard -.->|"views analytics"| node_analytics
node_api_server -->|"registers routes"| node_auth_routes
node_api_server -->|"registers routes"| node_user_routes
node_api_server -->|"registers routes"| node_chat_route
node_api_server -->|"registers routes"| node_sources
node_api_server -->|"registers routes"| node_analytics
node_api_server -->|"registers routes"| node_integrations
node_auth_routes -->|"uses auth"| node_auth
node_auth_routes -->|"reads and writes"| node_mongo
node_auth -->|"reads users"| node_mongo
node_user_routes -->|"reads and writes"| node_mongo
node_tasks -->|"processes documents"| node_ingestion
node_tasks -->|"scrapes sites"| node_scraper
node_tasks -->|"chunks content"| node_chunking
node_rag -->|"chunks documents"| node_chunking
node_rag -->|"searches and stores"| node_vector
node_discord -->|"manages bots"| node_discord_manager
node_discord_manager -->|"generates responses"| node_chat_service
node_discord_manager -->|"retrieves context"| node_vector
node_discord_manager -->|"checks limits"| node_plans
node_chat_route -.->|"handles conversations"| node_chat_service
node_chat_service -.->|"retrieves context"| node_rag
node_chat_service -.->|"runs agent"| node_agent_runtime
node_agent_runtime -.->|"calls provider"| node_ai_providers
node_sources -.->|"queues ingestion"| node_tasks
node_messaging -.->|"connects platforms"| node_integrations

click node_builder "https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/pages/ChatbotBuilder.jsx"
click node_preview "https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/components/ChatPreviewModal.jsx"
click node_publicchat "https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/pages/PublicChat.jsx"
click node_widget "https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/public/embed.js"
click node_dashboard "https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/pages/Dashboard.jsx"
click node_router "https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/App.js"
click node_api_server "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/server.py"
click node_auth_routes "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/auth_router.py"
click node_auth "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/auth.py"
click node_user_routes "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/user_router.py"
click node_models "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/models.py"
click node_chat_route "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/chat.py"
click node_chat_service "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/chat_service.py"
click node_agent_runtime "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/agents/runtime.py"
click node_sources "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/sources.py"
click node_ingestion "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/document_processor.py"
click node_chunking "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/chunking_service.py"
click node_rag "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/rag_service.py"
click node_vector "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/vector_store.py"
click node_scraper "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/website_scraper.py"
click node_tasks "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/tasks.py"
click node_analytics "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/analytics.py"
click node_integrations "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/integrations.py"
click node_discord "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/discord.py"
click node_discord_manager "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/discord_bot_manager.py"
click node_plans "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/plan_service.py"
click node_cache "https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/cache_service.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_builder,node_preview,node_publicchat,node_widget,node_dashboard,node_router toneBlue
class node_api_server,node_auth_routes,node_auth,node_user_routes,node_models,node_mongo toneAmber
class node_chat_route,node_chat_service,node_agent_runtime,node_sources,node_ingestion,node_chunking,node_rag,node_vector,node_scraper toneMint
class node_tasks,node_analytics,node_integrations,node_discord,node_discord_manager,node_plans,node_cache toneRose
class node_visitor,node_ai_providers,node_messaging toneIndigo
```

## Components

### Web experiences

- [Agent builder](https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/pages/ChatbotBuilder.jsx): `frontend/src/pages/ChatbotBuilder.jsx`
- [Chat preview](https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/components/ChatPreviewModal.jsx): `frontend/src/components/ChatPreviewModal.jsx`
- [Public chat](https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/pages/PublicChat.jsx): `frontend/src/pages/PublicChat.jsx`
- [Embed widget](https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/public/embed.js): `frontend/public/embed.js`
- [Dashboard](https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [App routing](https://github.com/sumeet6288/botsmith15012026/blob/main/frontend/src/App.js): `frontend/src/App.js`

### API and accounts

- [API server](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/server.py): `backend/server.py`
- [Authentication routes](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/auth_router.py): `backend/routers/auth_router.py`
- [Token and auth](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/auth.py): `backend/auth.py`
- [User management](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/user_router.py): `backend/routers/user_router.py`
- [Domain models](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/models.py): `backend/models.py`
- **MongoDB**

### Agent and knowledge

- [Chat routes](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/chat.py): `backend/routers/chat.py`
- [Conversation service](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/chat_service.py): `backend/services/chat_service.py`
- [Agent runtime](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/agents/runtime.py): `backend/agents/runtime.py`
- [Source routes](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/sources.py): `backend/routers/sources.py`
- [Document processing](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/document_processor.py): `backend/services/document_processor.py`
- [Chunking](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/chunking_service.py): `backend/services/chunking_service.py`
- [RAG retrieval](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/rag_service.py): `backend/services/rag_service.py`
- [Text vector store](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/vector_store.py): `backend/services/vector_store.py`
- [Website scraping](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/website_scraper.py): `backend/services/website_scraper.py`

### Integrations and operations

- [Background tasks](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/tasks.py): `backend/tasks.py`
- [Analytics routes](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/analytics.py): `backend/routers/analytics.py`
- [Integration routes](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/integrations.py): `backend/routers/integrations.py`
- [Discord integration](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/routers/discord.py): `backend/routers/discord.py`
- [Discord bot manager](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/discord_bot_manager.py): `backend/services/discord_bot_manager.py`
- [Plans and limits](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/plan_service.py): `backend/services/plan_service.py`
- [Cache service](https://github.com/sumeet6288/botsmith15012026/blob/main/backend/services/cache_service.py): `backend/services/cache_service.py`

### Other components

- **Visitor**
- **AI providers**
- **Messaging platforms**

## Connections

- Visitor → App routing: opens app (evidence: `frontend/src/App.js`)
- App routing → Agent builder: routes to (evidence: `frontend/src/App.js`)
- App routing → Public chat: routes to (evidence: `frontend/src/App.js`)
- Agent builder → Chat preview: previews agent
- Chat preview → Chat routes: sends messages
- Visitor → Embed widget: opens widget
- Embed widget → Chat routes: requests chat
- Dashboard → Analytics routes: views analytics
- API server → Authentication routes: registers routes (evidence: `backend/server.py`)
- API server → User management: registers routes (evidence: `backend/server.py`)
- API server → Chat routes: registers routes (evidence: `backend/server.py`)
- API server → Source routes: registers routes (evidence: `backend/server.py`)
- API server → Analytics routes: registers routes (evidence: `backend/server.py`)
- API server → Integration routes: registers routes (evidence: `backend/server.py`)
- Authentication routes → Token and auth: uses auth (evidence: `backend/routers/auth_router.py`)
- Authentication routes → MongoDB: reads and writes (evidence: `backend/routers/auth_router.py`)
- Token and auth → MongoDB: reads users (evidence: `backend/auth.py`)
- User management → MongoDB: reads and writes (evidence: `backend/routers/user_router.py`)
- Background tasks → Document processing: processes documents (evidence: `backend/tasks.py`)
- Background tasks → Website scraping: scrapes sites (evidence: `backend/tasks.py`)
- Background tasks → Chunking: chunks content (evidence: `backend/tasks.py`)
- RAG retrieval → Chunking: chunks documents (evidence: `backend/services/rag_service.py`)
- RAG retrieval → Text vector store: searches and stores (evidence: `backend/services/rag_service.py`)
- Discord integration → Discord bot manager: manages bots (evidence: `backend/routers/discord.py`)
- Discord bot manager → Conversation service: generates responses (evidence: `backend/services/discord_bot_manager.py`)
- Discord bot manager → Text vector store: retrieves context (evidence: `backend/services/discord_bot_manager.py`)
- Discord bot manager → Plans and limits: checks limits (evidence: `backend/services/discord_bot_manager.py`)
- Chat routes → Conversation service: handles conversations
- Conversation service → RAG retrieval: retrieves context
- Conversation service → Agent runtime: runs agent
- Agent runtime → AI providers: calls provider
- Source routes → Background tasks: queues ingestion
- Messaging platforms → Integration routes: connects platforms
