Nexus-CLI (DeepSeek Web Bridge voor Golang) ⚡

De tool is volledig herschreven in pure Go (Golang), gebaseerd op een grondige analyse van de Node.js (FreeDeepseekAPI-EN) en Python (deepseek_bridge) projecten, en heeft geen runtime-afhankelijkheden.

Belangrijkste kenmerken

Parallelle PoW-oplosser in pure Go

  • Lost DeepSeek-serveruitdagingen op met het DeepSeekHashV1-algoritme (Keccak-f[1600] 1..23 rounds SHA3-256), geparallelliseerd over CPU-cores.
  • Lost uitdagingen met een moeilijkheidsgraad van 144.000 op in slechts ~40–50 milliseconden (geen CGO, WASM of Python-afhankelijkheden nodig).

Interactieve Terminal Chat (REPL)

  • Streamt het denkproces (reasoning_content) van het R1-model in real-time met specifieke styling (cursief/cyaan).
  • Gepolijste ANSI-gebruikersinterface met kleurrijke prompts en geanimeerde loading spinners.
  • Ingebouwde slash-commando's: /help, /new, /model, /thinking, /search, /whoami, /clear, /exit.

Ondersteuning voor eenmalige opdrachten en Unix-pipes

  • Directe CLI-vragen: nexus "Wat is quantum computing?"
  • Linux/macOS pipe-workflows: cat main.go | nexus "Review deze code op beveiliging en prestaties"

Proxy-server compatibel met OpenAI, Anthropic & Ollama (nexus serve)

  • POST /v1/chat/completions (OpenAI-formaat, SSE streaming en JSON)
  • POST /v1/messages (Anthropic Messages API — 100% compatibel met Claude Code en de Anthropic SDK!)
  • POST /v1/responses (OpenAI Responses API)
  • GET /v1/models en GET /v1/model-capabilities
  • GET /v1/sessions en POST /v1/sessions/reset
  • Naadloze verbinding met Open WebUI, Continue.dev, Cursor, Cline en andere OpenAI/Anthropic-clients.

Native Ollama API-emulatie <0xF0><0x9F><0xA6><0x99>

  • Emuleert GET /api/tags, POST /api/chat, POST /api/generate en GET /api/version.
  • Directe plug-and-play compatibiliteit met Open WebUI, Dify, AnythingLLM, Cursor, LlamaIndex en officiële Ollama SDK's.

Gestructureerde output en JSON-schema's 🎯

  • Forceert strikte JSON-output of valideert tegen JSON-schema's via de CLI, Ollama en OpenAI-endpoints.

Universele integraties (Launcher) 🚀

  • Een launcher met één commando voor Claude Code, DeepSeek Harness, Codex, OpenCode, Goose en Aider (Nexus start automatisch de proxy op de achtergrond).

Multi-Account Pool 👥

  • Roteert tussen meerdere DeepSeek-accounts via Round-Robin scheduling om rate-limit blokkades (HTTP 429) te voorkomen.

Beheer van authenticatie (nexus auth)

  • Handmatige login: nexus auth login (extraheert de userToken uit de LocalStorage van de browser).
  • Automatisch via Chrome: nexus auth chrome (leest het sessietoken uit het geheugen van de browser via CDP).
  • Accountinspectie: nexus auth whoami.

Systeemdiagnostiek (Doctor)

  • nexus doctor — controleert direct de geldigheid van tokens, serverconnectiviteit, PoW-oplosser prestaties en sessiecreatie.

Installatie & Build

Vereist Go 1.20+:

# Clone repository en navigeer naar de directory:
git clone https://github.com/xamrayev/nexus-cli.git
cd nexus-cli

# Build het executable binary:
go build -o bin/nexus .

# Installeer globaal in de systeem PATH (optioneel):
go install .

Authenticatie (Account koppelen)

Er zijn drie manieren om je DeepSeek-account te koppelen:

1. Interactieve CLI-prompt

Voer ./bin/nexus auth login uit. Je wordt gevraagd om je userToken:

  1. Open https://chat.deepseek.com in je browser.
  2. Druk op F12 (of Cmd+Option+I op macOS).
  3. Ga naar Application → Local Storage → https://chat.deepseek.com → kopieer de waarde van userToken en plak deze in de prompt.

2. Automatisch via Chrome (CDP)

Voer ./bin/nexus auth chrome uit. Dit start automatisch een Chrome-venster. Zodra je inlogt, vangt Nexus het sessietoken veilig op en slaat dit op.

3. Via .env bestand

Maak een .env bestand aan in de root van het project: DEEPSEEKTOKEN=jouwdeepseektokenhier

Gebruiksvoorbeelden

1. Interactieve Chat (REPL)

./bin/nexus chat
# Of simpelweg:
./bin/nexus

Voorbeeld van real-time R1 reasoning stream: nexus ❯ Waarom is de lucht blauw? 💭 Denkproces: De gebruiker vraagt naar de fysische oorzaak van de kleur van de lucht... Moet Rayleigh-verstrooiing van zonlicht door atmosferische moleculen uitleggen... 🤖 DeepSeek (deepseek-reasoner): De primaire reden dat de lucht blauw lijkt, is een fenomeen genaamd Rayleigh-verstrooiing...

2. Eenmalige prompt

./bin/nexus "Geef 3 belangrijke feiten over de algemene relativiteitstheorie"

3. Code-analyse via Unix Pipe

cat main.go | ./bin/nexus "Analyseer deze code op beveiligingslekken en prestatieknelpunten"

4. De lokale API Proxy Server draaien

./bin/nexus serve --port 9655

Je kunt nu elke tool (Cursor, Open WebUI, Claude Code) routeren naar http://localhost:9655/v1!

Voorbeeld cURL-verzoek in OpenAI-formaat:

curl http://localhost:9655/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-reasoner",
"messages": [{"role": "user", "content": "Hallo!"}],
"stream": true
}'

5. Native Ollama API-emulatie <0xF0><0x9F><0xA6><0x99>

Nexus implementeert de Ollama API-specificatie. Tools zoals Open WebUI, Dify, AnythingLLM, Cursor, LlamaIndex en officiële Ollama-bibliotheken kunnen direct verbinden met http://localhost:9655.

1. Beschikbare modellen ophalen (Ollama-formaat):

curl http://localhost:9655/api/tags

2. Ollama Chat verzoek (NDJSON streaming):

curl http://localhost:9655/api/chat -d '{
"model": "deepseek-reasoner",
"messages": [{"role": "user", "content": "Hallo!"}],
"stream": true
}'

Gebruik met de officiële Python Ollama SDK:

import ollama
client = ollama.Client(host="http://localhost:9655")
resp = client.chat(model="deepseek-reasoner", messages=[
{"role": "user", "content": "Schrijf een eenvoudige HTTP-server in Go"}
])
print(resp["message"]["content"])

6. Gestructureerde output & JSON-schema's 🎯

Forceer strikte JSON-output of conformeer aan een specifiek schema:

1. Directe JSON via CLI (pipeable naar jq):

./bin/nexus "Top 3 programmeertalen en hun primaire domeinen" --format json | jq .

2. Via Ollama API:

curl http://localhost:9655/api/chat -d '{
"model": "deepseek-reasoner",
"messages": [{"role": "user", "content": "Lijst 3 fruitsoorten 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": "Geef apparaatspecificaties als JSON terug"}],
"response_format": {"type": "json_object"}
}'

7. Universele integraties (Launcher) 🚀

Start coding-tools en agents met één commando; Nexus start automatisch de proxyserver op de achtergrond:

  • Claude Code CLI (powered by DeepSeek R1 / V3): ./bin/nexus launch claude
  • Official DeepSeek Harness CLI (@deepseek-ai/dsh): ./bin/nexus launch dsh
  • OpenAI Codex CLI: ./bin/nexus launch codex
  • OpenCode CLI: ./bin/nexus launch opencode
  • Block Goose AI Agent: ./bin/nexus launch goose
  • Aider Pair Programming CLI: ./bin/nexus launch aider
  • ChatGPT Desktop (macOS) & local bridge: ./bin/nexus launch chatgpt
  • Multi-Account Pool Monitor: ./bin/nexus launch pool
  • DeepSeek Agentic Eval & Benchmark Harness: ./bin/nexus launch harness

8. Multi-Account Pool 👥

Vermijd rate limits (HTTP 429) door te wisselen tussen meerdere DeepSeek-accounts via Round-Robin rotatie:

# Voeg een nieuw account toe
./bin/nexus auth add acc2 --chrome

# Lijst accounts op en controleer hun status
./bin/nexus auth list

# Wissel actief account
./bin/nexus auth switch acc2

# Valideer alle accounts in de pool
./bin/nexus auth test

9. Systeemdiagnostiek (Doctor)

./bin/nexus doctor

Projectstructuur

nexus-cli/
├── bin/
│   └── nexus                     # Gecompileerd binair uitvoerbaar bestand
├── cmd/
│   └── nexus/main.go             # CLI-commando dispatcher
├── pkg/
│   ├── deepseek/
│   │   ├── pow.go                # Parallelle DeepSeekHashV1 Keccak PoW-oplosser in pure Go
│   │   ├── pow_test.go           # PoW test suite & benchmarks
│   │   ├── stream.go             # SSE JSON patch & OpenAI stream parser
│   │   ├── stream_test.go        # Stream tests
│   │   ├── auth.go               # Token, sessie en profielbeheerder
│   │   ├── chrome_auth.go        # Geautomatiseerde Chrome CDP-authenticatie
│   │   ├── client.go             # DeepSeek Web API client (Chat, Sessies, Auto-retry)
│   │   └── types.go              # Modelconfiguraties en typedefinities
│   ├── server/
│   │   ├── server.go             # Lokale HTTP-proxyserver (Routing, CORS, Auth)
│   │   ├── server_test.go        # Server endpoint unit tests
│   │   ├── openai.go             # OpenAI Chat Completions API adapter
│   │   ├── anthropic.go          # Anthropic Messages API adapter (voor Claude Code)
│   │   └── session.go            # Agent sessie-isolatie en opruiming
│   ├── launcher/
│   │   └── launcher.go           # Launchers voor Claude Code, Codex, Goose, Aider, etc.
│   └── cli/
│       ├── terminal.go           # ANSI styling, banners en spinners
│       ├── repl.go               # Interactieve terminal chat & slash-commando's
│       ├── runner.go             # Single-prompt en Unix pipe runner
│       └── doctor.go             # End-to-end systeemdiagnostiek
├── main.go                       # Toegangspunt van de applicatie
├── go.mod                        # Go module definitie
├── README.md                     # Hoofddocumentatie (Engels)
├── README.ru.md                  # Russische documentatie (Русский)
└── README.uz.md                  # Oezbeekse documentatie (O'zbekcha)

Licentie

Gedistribueerd onder de MIT-licentie.