GitHub - xamrayev/nexus-cli

Nexus-CLI (DeepSeek Web Bridge for Golang) ⚡ English | Русский | O'zbekcha 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 Requires Go 1.20+: # 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: Create a .env file in the project root: DEEPSEEK_TOKEN=your_deepseek_token_here 💡 Usage Examples 1. Interactive Chat (REPL) ./bin/nexus chat Or simply: ./bin/nexus Real-time R1 reasoning stream: 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! Sample cURL request in OpenAI format: 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 }' Using the official Python Ollama SDK: 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) 📄 License Distributed under the MIT License.