Latest commit
History
Folders and files
Repository files navigation
Nexus-CLI (DeepSeek Web Bridge for Golang) ⚡
A high-performance Golang CLI utility and local API proxy server that enables any application or coding agent to connect to DeepSeek V3 ( deepseek-chat ) and R1 ( deepseek-reasoner / Thinking) models via a free web account ( chat.deepseek.com ), without requiring an official paid DeepSeek API key.
Rewritten from scratch in pure Go (Golang) based on in-depth analysis of Node.js ( FreeDeepseekAPI-EN ) and Python ( deepseek_bridge ) projects, featuring zero runtime dependencies .
🚀 Key Features
Pure Go Parallel PoW (Proof-of-Work) Solver: Solves DeepSeek server challenges using the DeepSeekHashV1 algorithm (Keccak-f[1600] 1..23 rounds SHA3-256) parallelized across CPU cores.
Solves difficulty 144,000 challenges in just ~40–50 milliseconds (no CGO, WASM, or Python dependencies required).
Interactive Terminal Chat (REPL): Streams the R1 model's thought process ( reasoning_content ) in real-time with dedicated styling (italic/cyan).
Polished ANSI UI with colorful prompts and animated loading spinners.
Built-in slash commands: /help , /new , /model , /thinking , /search , /whoami , /clear , /exit .
One-Off & Unix Pipe Support: Direct CLI queries: nexus "What is quantum computing?"
Linux/macOS pipe workflows: cat main.go | nexus "Review this code for security and performance"
OpenAI, Anthropic & Ollama Compatible Proxy Server ( nexus serve ): POST /v1/chat/completions (OpenAI format, SSE streaming, and JSON)
POST /v1/messages (Anthropic Messages API — 100% compatible with Claude Code and the Anthropic SDK!)
POST /v1/responses (OpenAI Responses API)
GET /v1/models and GET /v1/model-capabilities
GET /v1/sessions and POST /v1/sessions/reset
Connects seamlessly with Open WebUI, Continue.dev, Cursor, Cline, and any other OpenAI/Anthropic client.
Native Ollama API Emulation 🦙: Emulates GET /api/tags , POST /api/chat , POST /api/generate , GET /api/version .
Direct plug-and-play compatibility with Open WebUI, Dify, AnythingLLM, Cursor, LlamaIndex, and official Ollama SDKs.
Structured Outputs & JSON Schema 🎯: Enforce strict JSON output or validate against JSON Schemas across CLI, Ollama, and OpenAI endpoints.
Universal Integrations (Launcher) 🚀: One-command launcher for Claude Code, DeepSeek Harness, Codex, OpenCode, Goose, and Aider (Nexus automatically boots the proxy in the background).
Multi-Account Pool 👥: Rotate multiple DeepSeek accounts using Round-Robin scheduling to eliminate rate-limit roadblocks (HTTP 429).
Authentication Management ( nexus auth ): Manual login: nexus auth login (extract userToken from browser LocalStorage)
Automatic via Chrome: nexus auth chrome (reads session token from browser memory via CDP)
Account inspection: nexus auth whoami
System Diagnostics (Doctor): nexus doctor — instantly checks token validity, server connectivity, PoW solver performance, and session creation.
📦 Installation & Build
# Clone repository and navigate to directory: git clone https://github.com/xamrayev/nexus-cli.git cd nexus-cli # Build the executable binary: go build -o bin/nexus . # Install globally to system PATH (optional): go install .
🔑 Authentication (Account Linking)
There are 3 ways to connect your DeepSeek account:
1. Interactive CLI prompt:
./bin/nexus auth login
You will be prompted for your userToken :
Open https://chat.deepseek.com in your browser.
Press F12 (or Cmd+Option+I on macOS).
Navigate to Application -> Local Storage -> https://chat.deepseek.com -> copy the userToken value and paste it into the prompt.
2. Automatic via Chrome (CDP):
./bin/nexus auth chrome
This automatically launches a Chrome window. Once you log in, Nexus securely captures and stores the session token.
3. Via .env file:
DEEPSEEK_TOKEN = your_deepseek_token_here
💡 Usage Examples
1. Interactive Chat (REPL)
./bin/nexus chat
./bin/nexus
nexus ❯ Why is the sky blue? 💭 Thinking Process: The user is asking about the physical cause behind the color of the sky... Need to explain the mechanism of Rayleigh scattering of sunlight by atmospheric molecules... 🤖 DeepSeek (deepseek-reasoner): The primary reason the sky appears blue is due to a phenomenon called Rayleigh scattering...
2. One-off prompt
./bin/nexus " Provide 3 key facts about general relativity "
3. Code analysis via Unix Pipe
cat main.go | ./bin/nexus " Analyze this code for security vulnerabilities and performance bottlenecks "
4. Running the Local API Proxy Server
./bin/nexus serve --port 9655
You can now route any tool (Cursor, Open WebUI, Claude Code) to http://localhost:9655/v1 !
curl http://localhost:9655/v1/chat/completions \ -H " Content-Type: application/json " \ -d ' { "model": "deepseek-reasoner", "messages": [{"role": "user", "content": "Hello!"}], "stream": true } '
5. Native Ollama API Emulation 🦙
Nexus implements the Ollama API specification. Open WebUI, Dify, AnythingLLM, Cursor, LlamaIndex, and official Ollama libraries can connect directly to http://localhost:9655 :
# 1. Fetch available models (Ollama format) curl http://localhost:9655/api/tags # 2. Ollama Chat request (NDJSON streaming) curl http://localhost:9655/api/chat -d ' { "model": "deepseek-reasoner", "messages": [{"role": "user", "content": "Hello!"}], "stream": true } '
import ollama client = ollama . Client ( host = "http://localhost:9655" ) resp = client . chat ( model = "deepseek-reasoner" , messages = [ { "role" : "user" , "content" : "Write a simple HTTP server in Go" } ]) print ( resp [ "message" ][ "content" ])
6. Structured Outputs & JSON Schema 🎯
Enforce strict JSON output or conform to a specified schema:
# 1. Direct JSON from CLI (pipeable to jq) ./bin/nexus " Top 3 programming languages and their primary domains " --format json | jq . # 2. Via Ollama API: curl http://localhost:9655/api/chat -d ' { "model": "deepseek-reasoner", "messages": [{"role": "user", "content": "List 3 fruits in JSON"}], "format": "json", "stream": false } ' # 3. Via OpenAI API (response_format): curl http://localhost:9655/v1/chat/completions -d ' { "model": "deepseek-reasoner", "messages": [{"role": "user", "content": "Return device specs as JSON"}], "response_format": {"type": "json_object"} } '
7. Universal Integrations (Launcher) 🚀
Launch coding tools and agents with a single command — Nexus automatically boots the proxy server in the background:
# 1. Claude Code CLI (powered by DeepSeek R1 / V3) ./bin/nexus launch claude ./bin/nexus launch claude -p " Refactor this Go code " # 2. Official DeepSeek Harness CLI (@deepseek-ai/dsh) ./bin/nexus launch dsh # 3. OpenAI Codex CLI (auto-configured with responses wire API) ./bin/nexus launch codex # 4. OpenCode CLI (with automated config injection) ./bin/nexus launch opencode # 5. Block Goose AI Agent (via OpenAI provider) ./bin/nexus launch goose # 6. Aider Pair Programming CLI (with DeepSeek R1) ./bin/nexus launch aider # 7. ChatGPT Desktop (macOS) & local bridge ./bin/nexus launch chatgpt # 8. Multi-Account Pool Monitor ./bin/nexus launch pool # 9. DeepSeek Agentic Eval & Benchmark Harness ./bin/nexus launch harness
8. Multi-Account Pool 👥
Avoid rate limits (HTTP 429) by cycling through multiple DeepSeek accounts using Round-Robin rotation:
# Add a new account ./bin/nexus auth add acc2 --chrome # List accounts and check their status ./bin/nexus auth list # Switch active account ./bin/nexus auth switch acc2 # Validate all accounts in the pool ./bin/nexus auth test
9. System Diagnostics (Doctor)
./bin/nexus doctor
📁 Project Structure
nexus-cli/ ├── bin/ │ └── nexus # Compiled binary executable ├── cmd/ │ └── nexus/main.go # CLI command dispatcher ├── pkg/ │ ├── deepseek/ │ │ ├── pow.go # Pure Go parallel DeepSeekHashV1 Keccak PoW solver │ │ ├── pow_test.go # PoW test suite & benchmarks │ │ ├── stream.go # SSE JSON patch & OpenAI stream parser │ │ ├── stream_test.go # Stream tests │ │ ├── auth.go # Token, session, and profile manager │ │ ├── chrome_auth.go # Automated Chrome CDP authentication │ │ ├── client.go # DeepSeek Web API client (Chat, Sessions, Auto-retry) │ │ └── types.go # Model configs and type definitions │ ├── server/ │ │ ├── server.go # Local HTTP proxy server (Routing, CORS, Auth) │ │ ├── server_test.go # Server endpoint unit tests │ │ ├── openai.go # OpenAI Chat Completions API adapter │ │ ├── anthropic.go # Anthropic Messages API adapter (for Claude Code) │ │ └── session.go # Agent session isolation and cleanup │ ├── launcher/ │ │ └── launcher.go # Launchers for Claude Code, Codex, Goose, Aider, etc. │ └── cli/ │ ├── terminal.go # ANSI styling, banners, and spinners │ ├── repl.go # Interactive terminal chat & slash commands │ ├── runner.go # Single-prompt and Unix pipe runner │ └── doctor.go # End-to-end system diagnostics ├── main.go # Application entry point ├── go.mod # Go module definition ├── README.md # Main documentation (English) ├── README.ru.md # Russian documentation (Русский) └── README.uz.md # Uzbek documentation (O'zbekcha)