# forgetmeai/freedeepseekapi architecture

> Architecture diagram of the GitHub repository forgetmeai/freedeepseekapi, 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/forgetmeai/freedeepseekapi
- Repository: https://github.com/forgetmeai/freedeepseekapi

## Overview

FreeDeepseekAPI is a local proxy from OpenAI-, Anthropic-, and Responses-compatible clients to DeepSeek Web, using saved browser-session credentials. The main workflow accepts a request, maintains an agent session, obtains a proof-of-work solution, calls DeepSeek Web, then formats JSON or SSE output. Separate supported branches collect or import credentials and expose a Chrome extension exporter. The excerpts show key request, auth, and PoW behavior; API sub-capabilities and some server internals are documented but not fully sampled.

Main entry points: [`server.js`](https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js) (HTTP Proxy), [`chrome-extension/background.js`](https://github.com/forgetmeai/freedeepseekapi/blob/main/chrome-extension/background.js) (Extension Background), [`scripts/deepseek_chrome_auth.js`](https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/deepseek_chrome_auth.js) (Browser Login), [`scripts/auth.js`](https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/auth.js) (Auth Menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Proxy API"]
  node_server["HTTP Proxy<br/>[server.js]"]
  node_compat["API Shims<br/>[server.js]"]
  node_sessions["Agent Sessions<br/>[server.js]"]
  node_responses["JSON / SSE<br/>[server.js]"]
end

subgraph group_upstream["DeepSeek Runtime"]
  node_authdata["Auth File"]
  node_pow["PoW Solver<br/>[pow.js]"]
end

subgraph group_auth["Credential Setup"]
  node_authmenu["Auth Menu<br/>[auth.js]"]
  node_chromeauth["Browser Login"]
  node_importer["Credential Import<br/>[auth_import.js]"]
  node_doctor["Auth Diagnostics<br/>[doctor.js]"]
end

subgraph group_extension["Chrome Exporter"]
  node_extensionpopup["Extension Popup<br/>[popup.js]"]
  node_background["Extension Background<br/>[background.js]"]
  node_content["Tab Storage Reader<br/>[content.js]"]
  node_storage[("Extension Storage")]
end

node_client(("API Clients"))
node_agent(("DeepSeek Web"))
node_account(("DeepSeek Account"))
node_browser(("DeepSeek Browser Tab"))

node_client -->|"sends requests"| node_server
node_server -.->|"routes formats"| node_compat
node_server -->|"maintains sessions"| node_sessions
node_server -->|"solves challenges"| node_pow
node_server -.->|"calls Web API"| node_agent
node_server -.->|"reads credentials"| node_authdata
node_server -.->|"returns JSON / SSE"| node_responses
node_account -->|"logs in"| node_chromeauth
node_authmenu -->|"launches"| node_chromeauth
node_authmenu -->|"launches"| node_importer
node_chromeauth -.->|"writes credentials"| node_authdata
node_importer -->|"writes credentials"| node_authdata
node_doctor -->|"checks credentials"| node_authdata
node_doctor -->|"checks challenge"| node_agent
node_extensionpopup -->|"requests collect / export"| node_background
node_background -->|"reads localStorage"| node_content
node_content -->|"reads tab storage"| node_browser
node_background -->|"reads cookies"| node_browser
node_background -->|"stores credentials"| node_storage
node_extensionpopup -->|"exports JSON"| node_authdata

click node_server "https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js"
click node_compat "https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js"
click node_sessions "https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js"
click node_responses "https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js"
click node_pow "https://github.com/forgetmeai/freedeepseekapi/blob/main/lib/pow.js"
click node_authmenu "https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/auth.js"
click node_chromeauth "https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/deepseek_chrome_auth.js"
click node_importer "https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/auth_import.js"
click node_doctor "https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/doctor.js"
click node_extensionpopup "https://github.com/forgetmeai/freedeepseekapi/blob/main/chrome-extension/popup.js"
click node_background "https://github.com/forgetmeai/freedeepseekapi/blob/main/chrome-extension/background.js"
click node_content "https://github.com/forgetmeai/freedeepseekapi/blob/main/chrome-extension/content.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_server,node_compat,node_sessions,node_responses,node_client,node_browser toneBlue
class node_authdata,node_pow toneAmber
class node_authmenu,node_chromeauth,node_importer,node_doctor toneMint
class node_extensionpopup,node_background,node_content,node_storage toneRose
class node_agent,node_account toneIndigo
```

## Components

### Proxy API

- [HTTP Proxy](https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js): `server.js`
- [API Shims](https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js): `server.js`
- [Agent Sessions](https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js): `server.js`
- [JSON / SSE](https://github.com/forgetmeai/freedeepseekapi/blob/main/server.js): `server.js`

### DeepSeek Runtime

- **Auth File**
- [PoW Solver](https://github.com/forgetmeai/freedeepseekapi/blob/main/lib/pow.js): `lib/pow.js`

### Credential Setup

- [Auth Menu](https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/auth.js): `scripts/auth.js`
- [Browser Login](https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/deepseek_chrome_auth.js): `scripts/deepseek_chrome_auth.js`
- [Credential Import](https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/auth_import.js): `scripts/auth_import.js`
- [Auth Diagnostics](https://github.com/forgetmeai/freedeepseekapi/blob/main/scripts/doctor.js): `scripts/doctor.js`

### Chrome Exporter

- [Extension Popup](https://github.com/forgetmeai/freedeepseekapi/blob/main/chrome-extension/popup.js): `chrome-extension/popup.js`
- [Extension Background](https://github.com/forgetmeai/freedeepseekapi/blob/main/chrome-extension/background.js): `chrome-extension/background.js`
- [Tab Storage Reader](https://github.com/forgetmeai/freedeepseekapi/blob/main/chrome-extension/content.js): `chrome-extension/content.js`
- **Extension Storage**

### Other components

- **API Clients**
- **DeepSeek Web**
- **DeepSeek Account**
- **DeepSeek Browser Tab**

## Connections

- API Clients → HTTP Proxy: sends requests (evidence: `README.md`)
- HTTP Proxy → API Shims: routes formats (evidence: `README.md`)
- HTTP Proxy → Agent Sessions: maintains sessions (evidence: `server.js`)
- HTTP Proxy → PoW Solver: solves challenges (evidence: `lib/pow.js`)
- HTTP Proxy → DeepSeek Web: calls Web API (evidence: `README.md`)
- HTTP Proxy → Auth File: reads credentials (evidence: `README.md`)
- HTTP Proxy → JSON / SSE: returns JSON / SSE (evidence: `README.md`)
- DeepSeek Account → Browser Login: logs in (evidence: `README.md`)
- Auth Menu → Browser Login: launches (evidence: `scripts/auth.js`)
- Auth Menu → Credential Import: launches (evidence: `scripts/auth.js`)
- Browser Login → Auth File: writes credentials (evidence: `README.md`)
- Credential Import → Auth File: writes credentials (evidence: `scripts/auth_import.js`)
- Auth Diagnostics → Auth File: checks credentials (evidence: `scripts/doctor.js`)
- Auth Diagnostics → DeepSeek Web: checks challenge (evidence: `scripts/doctor.js`)
- Extension Popup → Extension Background: requests collect / export (evidence: `chrome-extension/popup.js`)
- Extension Background → Tab Storage Reader: reads localStorage (evidence: `chrome-extension/background.js`)
- Tab Storage Reader → DeepSeek Browser Tab: reads tab storage (evidence: `chrome-extension/content.js`)
- Extension Background → DeepSeek Browser Tab: reads cookies (evidence: `chrome-extension/background.js`)
- Extension Background → Extension Storage: stores credentials (evidence: `chrome-extension/background.js`)
- Extension Popup → Auth File: exports JSON (evidence: `chrome-extension/popup.js`)
