# atharvotech/freedeepseekapi-en architecture

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

- Interactive diagram: https://gitdiagram.com/atharvotech/freedeepseekapi-en
- Repository: https://github.com/atharvotech/freedeepseekapi-en

## Overview

FreeDeepseekAPI is a local proxy that adapts several LLM client APIs to DeepSeek Web, using saved browser-session credentials. Its main workflow is client request → local API handling → DeepSeek Web → compatible response or stream. The graph also shows credential setup through Chrome or the extension, plus session and model-capability features. The large server excerpt is partial, so its internal request-processing calls are not mapped as separate steps.

Main entry points: [`server.js`](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js) (Local API server), [`chrome-extension/background.js`](https://github.com/atharvotech/freedeepseekapi-en/blob/main/chrome-extension/background.js) (Extension worker), [`scripts/auth.js`](https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/auth.js) (Auth menu), [`lib/pow.js`](https://github.com/atharvotech/freedeepseekapi-en/blob/main/lib/pow.js) (Proof-of-work solver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_proxy["API proxy"]
  node_api_server["Local API server<br/>[server.js]"]
  node_openai_api["OpenAI API<br/>[server.js]"]
  node_anthropic_api["Anthropic shim<br/>[server.js]"]
  node_responses_api["Responses shim<br/>[server.js]"]
  node_streaming_tools["Streaming and tools<br/>[server.js]"]
  node_pow_solver["Proof-of-work solver<br/>[pow.js]"]
end

subgraph group_sessions["Sessions and capabilities"]
  node_agent_sessions["Agent sessions<br/>[server.js]"]
  node_model_capabilities["Model capabilities<br/>[server.js]"]
end

subgraph group_credentials["Credential setup"]
  node_auth_menu["Auth menu<br/>[auth.js]"]
  node_chrome_auth["Chrome login"]
  node_auth_import["Auth importer<br/>[auth_import.js]"]
  node_auth_file["Saved credentials"]
  node_doctor["Auth diagnostics<br/>[doctor.js]"]
end

subgraph group_extension["Browser extension"]
  node_extension_popup["Extension popup<br/>[popup.js]"]
  node_extension_worker["Extension worker<br/>[background.js]"]
  node_content_script["Page content script<br/>[content.js]"]
  node_extension_storage[("Extension credential storage")]
end

node_client_apps(("LLM clients"))
node_deepseek_web["DeepSeek Web"]

node_client_apps -->|"send requests"| node_api_server
node_api_server -->|"proxies requests"| node_deepseek_web
node_api_server -->|"serves endpoint"| node_openai_api
node_api_server -->|"serves endpoint"| node_anthropic_api
node_api_server -->|"serves endpoint"| node_responses_api
node_api_server -->|"supports features"| node_streaming_tools
node_api_server -->|"maintains sessions"| node_agent_sessions
node_api_server -->|"serves capabilities"| node_model_capabilities
node_auth_menu -->|"launches login"| node_chrome_auth
node_auth_menu -->|"launches import"| node_auth_import
node_chrome_auth -->|"saves credentials"| node_auth_file
node_auth_import -->|"writes credentials"| node_auth_file
node_doctor -->|"checks credentials"| node_auth_file
node_extension_popup -->|"requests collection"| node_extension_worker
node_extension_worker -->|"reads page storage"| node_content_script
node_extension_worker -->|"stores credentials"| node_extension_storage
node_extension_worker -->|"returns credentials"| node_extension_popup
node_api_server -->|"uses solver"| node_pow_solver
node_pow_solver -.->|"fetches WASM"| node_deepseek_web

click node_api_server "https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js"
click node_openai_api "https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js"
click node_anthropic_api "https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js"
click node_responses_api "https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js"
click node_streaming_tools "https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js"
click node_agent_sessions "https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js"
click node_model_capabilities "https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js"
click node_auth_menu "https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/auth.js"
click node_chrome_auth "https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/deepseek_chrome_auth.js"
click node_auth_import "https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/auth_import.js"
click node_doctor "https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/doctor.js"
click node_extension_popup "https://github.com/atharvotech/freedeepseekapi-en/blob/main/chrome-extension/popup.js"
click node_extension_worker "https://github.com/atharvotech/freedeepseekapi-en/blob/main/chrome-extension/background.js"
click node_content_script "https://github.com/atharvotech/freedeepseekapi-en/blob/main/chrome-extension/content.js"
click node_pow_solver "https://github.com/atharvotech/freedeepseekapi-en/blob/main/lib/pow.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_api_server,node_openai_api,node_anthropic_api,node_responses_api,node_streaming_tools,node_pow_solver,node_client_apps toneBlue
class node_agent_sessions,node_model_capabilities toneAmber
class node_auth_menu,node_chrome_auth,node_auth_import,node_auth_file,node_doctor toneMint
class node_extension_popup,node_extension_worker,node_content_script,node_extension_storage toneRose
class node_deepseek_web toneIndigo
```

## Components

### API proxy

- [Local API server](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js): `server.js`
- [OpenAI API](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js): `server.js`
- [Anthropic shim](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js): `server.js`
- [Responses shim](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js): `server.js`
- [Streaming and tools](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js): `server.js`
- [Proof-of-work solver](https://github.com/atharvotech/freedeepseekapi-en/blob/main/lib/pow.js): `lib/pow.js`

### Sessions and capabilities

- [Agent sessions](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js): `server.js`
- [Model capabilities](https://github.com/atharvotech/freedeepseekapi-en/blob/main/server.js): `server.js`

### Credential setup

- [Auth menu](https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/auth.js): `scripts/auth.js`
- [Chrome login](https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/deepseek_chrome_auth.js): `scripts/deepseek_chrome_auth.js`
- [Auth importer](https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/auth_import.js): `scripts/auth_import.js`
- **Saved credentials**
- [Auth diagnostics](https://github.com/atharvotech/freedeepseekapi-en/blob/main/scripts/doctor.js): `scripts/doctor.js`

### Browser extension

- [Extension popup](https://github.com/atharvotech/freedeepseekapi-en/blob/main/chrome-extension/popup.js): `chrome-extension/popup.js`
- [Extension worker](https://github.com/atharvotech/freedeepseekapi-en/blob/main/chrome-extension/background.js): `chrome-extension/background.js`
- [Page content script](https://github.com/atharvotech/freedeepseekapi-en/blob/main/chrome-extension/content.js): `chrome-extension/content.js`
- **Extension credential storage**

### Other components

- **LLM clients**
- **DeepSeek Web**

## Connections

- LLM clients → Local API server: send requests (evidence: `README.md`)
- Local API server → DeepSeek Web: proxies requests (evidence: `README.md`)
- Local API server → OpenAI API: serves endpoint (evidence: `README.md`)
- Local API server → Anthropic shim: serves endpoint (evidence: `README.md`)
- Local API server → Responses shim: serves endpoint (evidence: `README.md`)
- Local API server → Streaming and tools: supports features (evidence: `README.md`)
- Local API server → Agent sessions: maintains sessions (evidence: `README.md`)
- Local API server → Model capabilities: serves capabilities (evidence: `README.md`)
- Auth menu → Chrome login: launches login (evidence: `scripts/auth.js`)
- Auth menu → Auth importer: launches import (evidence: `scripts/auth.js`)
- Chrome login → Saved credentials: saves credentials (evidence: `README.md`)
- Auth importer → Saved credentials: writes credentials (evidence: `scripts/auth_import.js`)
- Auth diagnostics → Saved credentials: checks credentials (evidence: `scripts/doctor.js`)
- Extension popup → Extension worker: requests collection (evidence: `chrome-extension/popup.js`)
- Extension worker → Page content script: reads page storage (evidence: `chrome-extension/background.js`)
- Extension worker → Extension credential storage: stores credentials (evidence: `chrome-extension/background.js`)
- Extension worker → Extension popup: returns credentials (evidence: `chrome-extension/background.js`)
- Local API server → Proof-of-work solver: uses solver (evidence: `server.js`)
- Proof-of-work solver → DeepSeek Web: fetches WASM
