# owenma130-maker/edge-deepseek-bridge architecture

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

- Interactive diagram: https://gitdiagram.com/owenma130-maker/edge-deepseek-bridge
- Repository: https://github.com/owenma130-maker/edge-deepseek-bridge

## Overview

Edge DeepSeek Bridge exposes a local HTTP service that lets Claude Code or another client send prompts to, and read conversation history from, DeepSeek’s website through a Playwright-controlled browser—without using an API. The main flow is HTTP request → FastAPI route → DeepSeekAgent DOM operation → browser page → DeepSeek response, returned to the caller. The repository also includes a command-line collaboration coordinator and an example client. README documents stable-response detection, read-only-page handling, configurable truncation, and cross-platform browser support; these capabilities are described, but not all were visible in the sampled excerpts.

Main entry points: [`bridge/proxy_service.py`](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/proxy_service.py) (FastAPI Service), [`bridge/browser_controller.py`](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/browser_controller.py) (Browser Controller), [`bridge/deepseek_agent.py`](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/deepseek_agent.py) (DeepSeek Agent), [`bridge/config.py`](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/config.py) (Bridge Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP Bridge"]
  node_proxy["FastAPI Service<br/>[proxy_service.py]"]
end

subgraph group_browser["Browser Automation"]
  node_agent["DeepSeek Agent<br/>[deepseek_agent.py]"]
  node_controller["Browser Controller"]
end

subgraph group_clients["Claude Clients"]
  node_coordinator["Collaboration Coordinator"]
  node_example["Example Client<br/>[client_example.py]"]
end

subgraph group_settings["Runtime Settings"]
  node_config["Bridge Configuration<br/>[config.py]"]
end

node_claude(("Claude Code"))
node_caller(("HTTP Client"))
node_browser["Edge / Chromium"]
node_deepseek["DeepSeek Website"]

node_claude -->|"calls HTTP"| node_proxy
node_caller -->|"calls HTTP"| node_proxy
node_proxy -->|"starts browser"| node_controller
node_proxy -->|"gets page"| node_controller
node_proxy -->|"creates agent"| node_agent
node_proxy -->|"reads history"| node_agent
node_proxy -->|"sends prompt"| node_agent
node_controller -->|"launches browser"| node_browser
node_controller -->|"opens website"| node_deepseek
node_agent -->|"operates DOM"| node_deepseek
node_controller -->|"reads settings"| node_config
node_agent -->|"reads selectors"| node_config
node_proxy -->|"reads service settings"| node_config
node_coordinator -->|"calls HTTP"| node_proxy
node_example -->|"calls HTTP"| node_proxy

click node_proxy "https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/proxy_service.py"
click node_agent "https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/deepseek_agent.py"
click node_controller "https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/browser_controller.py"
click node_config "https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/config.py"
click node_coordinator "https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/deepseek_coordinator.py"
click node_example "https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/client_example.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_proxy,node_caller toneBlue
class node_agent,node_controller toneAmber
class node_coordinator,node_example toneMint
class node_config toneRose
class node_claude,node_browser,node_deepseek toneIndigo
```

## Components

### HTTP Bridge

- [FastAPI Service](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/proxy_service.py): `bridge/proxy_service.py`

### Browser Automation

- [DeepSeek Agent](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/deepseek_agent.py): `bridge/deepseek_agent.py`
- [Browser Controller](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/browser_controller.py): `bridge/browser_controller.py`

### Claude Clients

- [Collaboration Coordinator](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/deepseek_coordinator.py): `bridge/deepseek_coordinator.py`
- [Example Client](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/client_example.py): `bridge/client_example.py`

### Runtime Settings

- [Bridge Configuration](https://github.com/owenma130-maker/edge-deepseek-bridge/blob/main/bridge/config.py): `bridge/config.py`

### Other components

- **Claude Code**
- **HTTP Client**
- **Edge / Chromium**
- **DeepSeek Website**

## Connections

- Claude Code → FastAPI Service: calls HTTP (evidence: `README.md`)
- HTTP Client → FastAPI Service: calls HTTP (evidence: `README.md`)
- FastAPI Service → Browser Controller: starts browser (evidence: `bridge/proxy_service.py`)
- FastAPI Service → Browser Controller: gets page (evidence: `bridge/proxy_service.py`)
- FastAPI Service → DeepSeek Agent: creates agent (evidence: `bridge/proxy_service.py`)
- FastAPI Service → DeepSeek Agent: reads history (evidence: `bridge/proxy_service.py`)
- FastAPI Service → DeepSeek Agent: sends prompt (evidence: `bridge/proxy_service.py`)
- Browser Controller → Edge / Chromium: launches browser (evidence: `bridge/browser_controller.py`)
- Browser Controller → DeepSeek Website: opens website (evidence: `bridge/browser_controller.py`)
- DeepSeek Agent → DeepSeek Website: operates DOM (evidence: `bridge/deepseek_agent.py`)
- Browser Controller → Bridge Configuration: reads settings (evidence: `bridge/browser_controller.py`)
- DeepSeek Agent → Bridge Configuration: reads selectors (evidence: `bridge/deepseek_agent.py`)
- FastAPI Service → Bridge Configuration: reads service settings (evidence: `bridge/proxy_service.py`)
- Collaboration Coordinator → FastAPI Service: calls HTTP (evidence: `bridge/deepseek_coordinator.py`)
- Example Client → FastAPI Service: calls HTTP (evidence: `bridge/client_example.py`)
