# chaoticmindv/deepseek2api architecture

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

- Interactive diagram: https://gitdiagram.com/chaoticmindv/deepseek2api
- Repository: https://github.com/chaoticmindv/deepseek2api

## Overview

deepseek2api is a lightweight HTTP proxy that translates OpenAI Chat Completions requests into DeepSeek Web conversations and converts responses back, including streaming and tool calls. The main path is an API client request through HTTP routing and validation, upstream session/authentication and conversation processing, then an OpenAI-compatible response. Separate branches provide model discovery and an admin console with request metrics. The graph follows documented capabilities; some service-to-service wiring is supported by the source index rather than complete excerpts, so unverified optional links are omitted.

Main entry points: [`src/deepseek2api/services/deepseek_client.py`](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/deepseek_client.py) (Upstream Client), [`src/deepseek2api/server.py`](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/server.py) (HTTP Router), [`src/deepseek2api/app.py`](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/app.py) (Application), [`src/deepseek2api/services/deepseek_auth.py`](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/deepseek_auth.py) (Credential Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Service Runtime"]
  node_entry["CLI Entry<br/>[__main__.py]"]
  node_application["Application<br/>[app.py]"]
  node_configuration["Configuration<br/>[config.py]"]
  node_logging["Logging<br/>[logging_utils.py]"]
end

subgraph group_api["OpenAI API"]
  node_http_server["HTTP Router<br/>[server.py]"]
  node_openai_shapes["OpenAI Structures<br/>[openai_compat.py]"]
  node_model_profiles["Model Profiles<br/>[model_profiles.py]"]
  node_translator["Message Translator<br/>[translator.py]"]
end

subgraph group_upstream["DeepSeek Services"]
  node_deepseek_client["Upstream Client<br/>[deepseek_client.py]"]
  node_auth["Credential Manager<br/>[deepseek_auth.py]"]
  node_cookie_jar["Cookie Jar<br/>[cookie_jar.py]"]
  node_pow["PoW Solver<br/>[pow_solver.py]"]
  node_sessions["Session Cache<br/>[session_cache.py]"]
  node_tool_calls["Tool Calling<br/>[tool_calling.py]"]
  node_citations["Citation Cleanup<br/>[citation_utils.py]"]
  node_uploader["Image Uploader<br/>[file_uploader.py]"]
end

subgraph group_admin["Admin Console"]
  node_admin_api["Admin API<br/>[api.py]"]
  node_admin_store[("Metrics Store<br/>[store.py]")]
  node_admin_ui["Admin UI<br/>[app.js]"]
end

node_client_actor(("API Client"))
node_deepseek_web{{"DeepSeek Web"}}

node_client_actor -->|"sends requests"| node_http_server
node_entry -->|"starts"| node_application
node_application -->|"loads"| node_configuration
node_application -->|"creates"| node_deepseek_client
node_application -->|"creates"| node_http_server
node_application -->|"configures"| node_logging
node_http_server -->|"dispatches chat"| node_deepseek_client
node_http_server -->|"formats errors"| node_openai_shapes
node_http_server -.->|"serves models"| node_model_profiles
node_http_server -->|"routes admin"| node_admin_api
node_deepseek_client -->|"converts messages"| node_translator
node_deepseek_client -->|"gets credentials"| node_auth
node_deepseek_client -->|"solves challenges"| node_pow
node_deepseek_client -->|"reuses sessions"| node_sessions
node_deepseek_client -->|"parses tools"| node_tool_calls
node_deepseek_client -->|"strips citations"| node_citations
node_deepseek_client -->|"uploads images"| node_uploader
node_deepseek_client -->|"sends conversations"| node_deepseek_web
node_auth -->|"manages cookies"| node_cookie_jar
node_auth -->|"fetches auth tokens"| node_deepseek_web
node_uploader -->|"uploads files"| node_deepseek_web
node_translator -->|"encodes tools"| node_tool_calls
node_admin_ui -->|"calls endpoints"| node_admin_api
node_admin_api -->|"reads metrics"| node_admin_store
node_http_server -.->|"records requests"| node_admin_store

click node_entry "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/__main__.py"
click node_application "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/app.py"
click node_configuration "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/config.py"
click node_logging "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/logging_utils.py"
click node_http_server "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/server.py"
click node_openai_shapes "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/core/openai_compat.py"
click node_model_profiles "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/core/model_profiles.py"
click node_translator "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/translator.py"
click node_deepseek_client "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/deepseek_client.py"
click node_auth "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/deepseek_auth.py"
click node_cookie_jar "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/cookie_jar.py"
click node_pow "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/pow_solver.py"
click node_sessions "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/session_cache.py"
click node_tool_calls "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/tool_calling.py"
click node_citations "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/citation_utils.py"
click node_uploader "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/file_uploader.py"
click node_admin_api "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/admin/api.py"
click node_admin_store "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/admin/store.py"
click node_admin_ui "https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/admin/static/app.js"

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_entry,node_application,node_configuration,node_logging,node_client_actor toneBlue
class node_http_server,node_openai_shapes,node_model_profiles,node_translator toneAmber
class node_deepseek_client,node_auth,node_cookie_jar,node_pow,node_sessions,node_tool_calls,node_citations,node_uploader toneMint
class node_admin_api,node_admin_store,node_admin_ui toneRose
class node_deepseek_web toneIndigo
```

## Components

### Service Runtime

- [CLI Entry](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/__main__.py): `src/deepseek2api/__main__.py`
- [Application](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/app.py): `src/deepseek2api/app.py`
- [Configuration](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/config.py): `src/deepseek2api/config.py`
- [Logging](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/logging_utils.py): `src/deepseek2api/logging_utils.py`

### OpenAI API

- [HTTP Router](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/server.py): `src/deepseek2api/server.py`
- [OpenAI Structures](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/core/openai_compat.py): `src/deepseek2api/core/openai_compat.py`
- [Model Profiles](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/core/model_profiles.py): `src/deepseek2api/core/model_profiles.py`
- [Message Translator](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/translator.py): `src/deepseek2api/services/translator.py`

### DeepSeek Services

- [Upstream Client](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/deepseek_client.py): `src/deepseek2api/services/deepseek_client.py`
- [Credential Manager](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/deepseek_auth.py): `src/deepseek2api/services/deepseek_auth.py`
- [Cookie Jar](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/cookie_jar.py): `src/deepseek2api/services/cookie_jar.py`
- [PoW Solver](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/pow_solver.py): `src/deepseek2api/services/pow_solver.py`
- [Session Cache](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/session_cache.py): `src/deepseek2api/services/session_cache.py`
- [Tool Calling](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/tool_calling.py): `src/deepseek2api/services/tool_calling.py`
- [Citation Cleanup](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/citation_utils.py): `src/deepseek2api/services/citation_utils.py`
- [Image Uploader](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/services/file_uploader.py): `src/deepseek2api/services/file_uploader.py`

### Admin Console

- [Admin API](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/admin/api.py): `src/deepseek2api/admin/api.py`
- [Metrics Store](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/admin/store.py): `src/deepseek2api/admin/store.py`
- [Admin UI](https://github.com/chaoticmindv/deepseek2api/blob/main/src/deepseek2api/admin/static/app.js): `src/deepseek2api/admin/static/app.js`

### Other components

- **API Client**
- **DeepSeek Web**

## Connections

- API Client → HTTP Router: sends requests (evidence: `README.md`)
- CLI Entry → Application: starts (evidence: `src/deepseek2api/__main__.py`)
- Application → Configuration: loads (evidence: `src/deepseek2api/app.py`)
- Application → Upstream Client: creates (evidence: `src/deepseek2api/app.py`)
- Application → HTTP Router: creates (evidence: `src/deepseek2api/app.py`)
- Application → Logging: configures (evidence: `src/deepseek2api/app.py`)
- HTTP Router → Upstream Client: dispatches chat (evidence: `src/deepseek2api/server.py`)
- HTTP Router → OpenAI Structures: formats errors (evidence: `src/deepseek2api/server.py`)
- HTTP Router → Model Profiles: serves models (evidence: `README.md`)
- HTTP Router → Admin API: routes admin (evidence: `src/deepseek2api/server.py`)
- Upstream Client → Message Translator: converts messages (evidence: `src/deepseek2api/services/deepseek_client.py`)
- Upstream Client → Credential Manager: gets credentials (evidence: `src/deepseek2api/services/deepseek_client.py`)
- Upstream Client → PoW Solver: solves challenges (evidence: `src/deepseek2api/services/deepseek_client.py`)
- Upstream Client → Session Cache: reuses sessions (evidence: `src/deepseek2api/services/deepseek_client.py`)
- Upstream Client → Tool Calling: parses tools (evidence: `src/deepseek2api/services/deepseek_client.py`)
- Upstream Client → Citation Cleanup: strips citations (evidence: `src/deepseek2api/services/deepseek_client.py`)
- Upstream Client → Image Uploader: uploads images (evidence: `src/deepseek2api/services/deepseek_client.py`)
- Upstream Client → DeepSeek Web: sends conversations (evidence: `README.md`)
- Credential Manager → Cookie Jar: manages cookies (evidence: `src/deepseek2api/services/deepseek_auth.py`)
- Credential Manager → DeepSeek Web: fetches auth tokens (evidence: `src/deepseek2api/services/deepseek_auth.py`)
- Image Uploader → DeepSeek Web: uploads files (evidence: `src/deepseek2api/services/file_uploader.py`)
- Message Translator → Tool Calling: encodes tools (evidence: `src/deepseek2api/services/translator.py`)
- Admin UI → Admin API: calls endpoints (evidence: `README.md`)
- Admin API → Metrics Store: reads metrics (evidence: `src/deepseek2api/admin/api.py`)
- HTTP Router → Metrics Store: records requests (evidence: `src/deepseek2api/server.py`)
