# guinogueira21/fastapi-gemini-agent architecture

> Architecture diagram of the GitHub repository guinogueira21/fastapi-gemini-agent, 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/guinogueira21/fastapi-gemini-agent
- Repository: https://github.com/guinogueira21/fastapi-gemini-agent

## Overview

This is a small FastAPI chat service. A client posts a prompt to the chat route; the route applies an in-memory rate limit, then calls a Gemini adapter and returns its response. The service loads a system prompt from a Markdown file and configures the adapter with an environment-provided API key. The abstract AI interface is the internal extension layer. The source excerpts show these calls and configuration; no broader capabilities are documented.

Main entry points: [`src/main.py`](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/main.py) (FastAPI Chat API), [`src/ai/gemini.py`](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/ai/gemini.py) (Gemini Adapter), [`src/auth/throttling.py`](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/auth/throttling.py) (Request Throttler), [`src/prompts/system_prompt.md`](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/prompts/system_prompt.md) (System Prompt)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["FastAPI Chat API<br/>[main.py]"]
end

subgraph group_limits["Rate Limiting"]
  node_limiter["Request Throttler<br/>[throttling.py]"]
end

subgraph group_ai["AI Integration"]
  node_prompt["System Prompt<br/>[system_prompt.md]"]
  node_interface["AI Platform Interface<br/>[base.py]"]
  node_gemini["Gemini Adapter<br/>[gemini.py]"]
end

node_client(("API Client"))
node_google["Google Gemini API"]

node_client -->|"posts prompt"| node_app
node_app -->|"checks limit"| node_limiter
node_app -->|"sends prompt"| node_gemini
node_app -->|"loads prompt"| node_prompt
node_gemini -->|"implements"| node_interface
node_gemini -->|"generates content"| node_google
node_app -->|"returns response"| node_client

click node_app "https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/main.py"
click node_limiter "https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/auth/throttling.py"
click node_prompt "https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/prompts/system_prompt.md"
click node_interface "https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/ai/base.py"
click node_gemini "https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/ai/gemini.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_app,node_client toneBlue
class node_limiter toneAmber
class node_prompt,node_interface,node_gemini,node_google toneMint
```

## Components

### HTTP API

- [FastAPI Chat API](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/main.py): `src/main.py`

### Rate Limiting

- [Request Throttler](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/auth/throttling.py): `src/auth/throttling.py`

### AI Integration

- [System Prompt](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/prompts/system_prompt.md): `src/prompts/system_prompt.md`
- [AI Platform Interface](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/ai/base.py): `src/ai/base.py`
- [Gemini Adapter](https://github.com/guinogueira21/fastapi-gemini-agent/blob/main/src/ai/gemini.py): `src/ai/gemini.py`

### Other components

- **API Client**
- **Google Gemini API**

## Connections

- API Client → FastAPI Chat API: posts prompt (evidence: `src/main.py`)
- FastAPI Chat API → Request Throttler: checks limit (evidence: `src/main.py`)
- FastAPI Chat API → Gemini Adapter: sends prompt (evidence: `src/main.py`)
- FastAPI Chat API → System Prompt: loads prompt (evidence: `src/main.py`)
- Gemini Adapter → AI Platform Interface: implements (evidence: `src/ai/gemini.py`)
- Gemini Adapter → Google Gemini API: generates content (evidence: `src/ai/gemini.py`)
- FastAPI Chat API → API Client: returns response (evidence: `src/main.py`)
