# zeynbabid246-beep/agentai-llm architecture

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

- Interactive diagram: https://gitdiagram.com/zeynbabid246-beep/agentai-llm
- Repository: https://github.com/zeynbabid246-beep/agentai-llm

## Overview

Smart Agent API is a browser-based conversational assistant. A user submits a message through the chat UI; the FastAPI endpoint invokes the LangChain executor, which uses Gemini to answer or select a tool, then returns the response for display. Tool-backed capabilities include web search, Wikipedia lookup, and calculation; ordinary conversation is handled by the model. The graph reflects sampled backend and frontend code; external service calls are inferred from the documented tools and their implementations.

Main entry points: [`AgentAI-guide-main/Backend/agent.py`](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/agent.py) (Agent executor), [`AgentAI-guide-main/frontend/script.js`](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/frontend/script.js) (Chat UI), [`AgentAI-guide-main/Backend/tools.py`](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py) (Tool setup), [`AgentAI-guide-main/Backend/main.py`](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/main.py) (Chat endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Chat client"]
  node_chat_ui["Chat UI<br/>[script.js]"]
end

subgraph group_service["API service"]
  node_api["Chat endpoint<br/>[main.py]"]
end

subgraph group_agent["Agent runtime"]
  node_executor["Agent executor<br/>[agent.py]"]
  node_react_agent["ReAct agent<br/>[agent.py]"]
  node_gemini["Gemini model<br/>[agent.py]"]
end

subgraph group_capabilities["Agent tools"]
  node_tool_setup["Tool setup<br/>[tools.py]"]
  node_search_tool["Web search<br/>[tools.py]"]
  node_wiki_tool["Wikipedia lookup<br/>[tools.py]"]
  node_calculator["Calculator<br/>[tools.py]"]
end

node_user(("User"))
node_google{{"Google Gemini"}}
node_duckduckgo{{"DuckDuckGo"}}
node_wikipedia{{"Wikipedia"}}

node_user -->|"enters message"| node_chat_ui
node_chat_ui -->|"POST message"| node_api
node_api -->|"invokes"| node_executor
node_executor -->|"runs"| node_react_agent
node_react_agent -->|"requests completion"| node_gemini
node_gemini -->|"calls model"| node_google
node_executor -->|"dispatches"| node_search_tool
node_executor -->|"dispatches"| node_wiki_tool
node_executor -->|"dispatches"| node_calculator
node_tool_setup -->|"creates"| node_search_tool
node_tool_setup -->|"creates"| node_wiki_tool
node_tool_setup -->|"creates"| node_calculator
node_search_tool -->|"searches"| node_duckduckgo
node_wiki_tool -->|"queries"| node_wikipedia
node_calculator -->|"uses model"| node_gemini
node_api -->|"returns response"| node_chat_ui
node_chat_ui -->|"displays reply"| node_user

click node_chat_ui "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/frontend/script.js"
click node_api "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/main.py"
click node_executor "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/agent.py"
click node_react_agent "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/agent.py"
click node_tool_setup "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py"
click node_gemini "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/agent.py"
click node_search_tool "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py"
click node_wiki_tool "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py"
click node_calculator "https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.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_chat_ui,node_user toneBlue
class node_api toneAmber
class node_executor,node_react_agent,node_gemini toneMint
class node_tool_setup,node_search_tool,node_wiki_tool,node_calculator toneRose
class node_google,node_duckduckgo,node_wikipedia toneIndigo
```

## Components

### Chat client

- [Chat UI](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/frontend/script.js): `AgentAI-guide-main/frontend/script.js`

### API service

- [Chat endpoint](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/main.py): `AgentAI-guide-main/Backend/main.py`

### Agent runtime

- [Agent executor](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/agent.py): `AgentAI-guide-main/Backend/agent.py`
- [ReAct agent](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/agent.py): `AgentAI-guide-main/Backend/agent.py`
- [Gemini model](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/agent.py): `AgentAI-guide-main/Backend/agent.py`

### Agent tools

- [Tool setup](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py): `AgentAI-guide-main/Backend/tools.py`
- [Web search](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py): `AgentAI-guide-main/Backend/tools.py`
- [Wikipedia lookup](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py): `AgentAI-guide-main/Backend/tools.py`
- [Calculator](https://github.com/zeynbabid246-beep/agentai-llm/blob/main/AgentAI-guide-main/Backend/tools.py): `AgentAI-guide-main/Backend/tools.py`

### Other components

- **User**
- **Google Gemini**
- **DuckDuckGo**
- **Wikipedia**

## Connections

- User → Chat UI: enters message
- Chat UI → Chat endpoint: POST message
- Chat endpoint → Agent executor: invokes
- Agent executor → ReAct agent: runs
- ReAct agent → Gemini model: requests completion
- Gemini model → Google Gemini: calls model
- Agent executor → Web search: dispatches
- Agent executor → Wikipedia lookup: dispatches
- Agent executor → Calculator: dispatches
- Tool setup → Web search: creates
- Tool setup → Wikipedia lookup: creates
- Tool setup → Calculator: creates
- Web search → DuckDuckGo: searches
- Wikipedia lookup → Wikipedia: queries
- Calculator → Gemini model: uses model
- Chat endpoint → Chat UI: returns response
- Chat UI → User: displays reply