TLDR DeepSeek Harness (dsh) is de open-source agent-runtime van DeepSeek AI, uitgebracht als developer preview rond 13 augustus 2026 onder de MIT-licentie. Het volgt het principe “Model + Harness = Agent”, waarbij elke capability (modellen, tools, sessies, sandboxes, loops, UI) is geïmplementeerd als verwisselbare Cordis-plugins.
De snelste manier om het lokaal uit te voeren is npx @deepseek-ai/dsh web (vereist Node.js ^22.19 of ≥24), wat een Web UI start op http://127.0.0.1:3080. Je levert een DeepSeek- (of OpenAI-compatibele) API-sleutel en een workspace aan. Source-builds, desktop-apps, Docker, Python SDK en Ollama-integraties zijn ook beschikbaar. Voor productieklare multi-modeltoegang, betrouwbaarheid en kostenbeheersing bij gebruik van de harness, routeer verzoeken via het OpenAI-compatibele uniforme endpoint van CometAPI.
Belangrijkste punten
- DeepSeek Harness is geen model—het is de lokale runtime/orchestrator die modellen laat opereren op bestanden, shells, tools en sessies.
- Officiële one-liner:
npx @deepseek-ai/dsh web→ opent lokale Web UI op poort 3080. - Node.js-vereiste is strikt: ^22.19.0 of ≥24.x.
- Ondersteunt DeepSeek officiële modellen (deepseek-v4-flash, deepseek-v4-pro), aangepaste OpenAI-compatibele gateways en lokale modellen via plugins/Ollama.
- Architectuur is volledig plugin-based (Cordis-kernel); modi omvatten Standard, Minimal, Code en Creator.
- Snelle adoptie: tienduizenden tot ruim boven de 100k GitHub-sterren binnen dagen na lancering.
- Aanbevolen voor power users: combineer met CometAPI (https://www.cometapi.com/) als een aangepaste provider voor toegang tot 500+ modellen, 20–40% kostenbesparing en één enkele API-sleutel.
- Gebruik altijd een geïsoleerde workspace; de agent kan bestanden wijzigen en commando’s uitvoeren.
- Developer preview-status betekent dat breaking changes te verwachten zijn—pin versies voor productie-achtige experimenten.
Wat is DeepSeek Harness en waarom het ertoe doet in 2026
DeepSeek Harness (dsh) is een open-source agent-runtime ontwikkeld door DeepSeek AI. Uitgebracht onder de MIT-licentie als developer preview, legt het de nadruk op composability: elke capability—modeladapters, tools, skills, sessies, sandboxes, opslag, agent-loops, scheduling en de UI—bestaat als een Cordis-plugin die via configuratie gemount, unmounted, verwisseld of hergecomposeerd kan worden. Er is in feite geen geprivilegieerde kern die patching vereist.
Belangrijke ontwerpprincipes omvatten:
- Agent = Model + Harness.
- Traceerbare event streams met ondersteuning voor resume, fork, search en replay.
- Meerdere runtime-modi (standaard volledige toolset, code/orchestratiemodus, minimale modus voor benchmarking, creator/experimentele modi).
- Local-first Web UI voor interactieve inzet plus headless- en SDK-opties voor automatisering.
Officiële resources:
- GitHub: https://github.com/deepseek-ai/deepseek-harness
- Product/landing: https://www.deepseek.com/harness/en/ (en Chinese tegenhanger)
- Installatiehandleidingen en community-mirrors benadrukken dezelfde kerncommando’s.
Belangrijke terminologie-opmerking: “lokale deployment” kan twee verschillende dingen betekenen. De hier besproken DeepSeek Harness draait lokaal op je computer, maar het standaardproject
deepseek-harnessmaakt verbinding met DeepSeek V4-Pro of V4-Flash via een API. Dat betekent dat de harness, configuratie, sessies, validatie en clientlogica lokaal kunnen zijn, terwijl modelinference normaal gesproken wordt uitgevoerd door de API van DeepSeek. Als je echt offline inference met modelgewichten op je eigen GPU nodig hebt, is dat een andere deployment-architectuur.
Vereisten en systeemvereisten
Controleer vóór installatie het volgende:
- besturingssystemen: Windows 10+, macOS 10.15+, gangbare Linux (x64 of arm64). Python SDK heeft extra beperkingen (Linux x64/arm64 of macOS 14+ arm64).
- Node.js: Vereist voor het hoofdpad via de Web UI. Doelbereik is ^22.19.0 || ≥24.0.0. Controleer met node --version. Oneven tussentijdse versies buiten dit bereik worden niet ondersteund.
- Pakketmanagers: npm/npx (wordt meegeleverd met Node). Source-builds vereisen pnpm (installeren via npm install -g pnpm).
- Git: Vereist voor source-cloning.
- Python (optioneel): 3.10+ voor de officiële Python SDK.
- API-sleutel / endpoint: Een DeepSeek API-sleutel van platform.deepseek.com, of een OpenAI-compatibel endpoint + sleutel + modelnaam.
- Hardware: Geen GPU vereist voor de harness zelf—de modelinference gebeurt extern (of via een lokale provider die je configureert). Gewone laptopresources volstaan voor de Web UI en orkestratie.
- Netwerk: Nodig bij de eerste run om pakketten te ophalen; daarna kan de UI werken met alleen model-API-calls.
- Workspace: Bereid een geïsoleerde directory voor. De agent kan lezen, schrijven en commando’s uitvoeren binnen de geconfigureerde workspace—wijs nooit naar productie of persoonlijke data zonder waarborgen.
Bronnen voor vereisten: officiële README en meerdere onafhankelijke installatiegidsen die kort na launch zijn gepubliceerd.
Methode 1: Officiële one-liner met npx (aanbevolen voor de meeste gebruikers)
Dit is het snelste en officieel gepromote pad.
- Zorg dat Node.js aan de versievereiste voldoet.
- Open een terminal en voer uit:
Bash
npx @deepseek-ai/dsh web
- Het pakket wordt gedownload (of gebruikt de cache), start het Web UI-profiel en print het luisteradres—standaard http://127.0.0.1:3080.
- Open die URL in een browser. Accepteer de developer-preview-melding indien getoond.
- Configureer bij eerste gebruik een modelprovider (Settings → Models) door je API-sleutel te plakken en een model te kiezen, zoals deepseek-v4-flash of deepseek-v4-pro.
- Kies of maak een workspace-directory.
- Begin met het uitvoeren van taken.
Om een andere poort te gebruiken:
Bash
npx @deepseek-ai/dsh web --port 8080
Platformspecifieke one-liners die er ook voor zorgen dat Node aanwezig is, zijn beschikbaar via communitysites (PowerShell op Windows met winget, Homebrew op macOS, NodeSource op Debian/Ubuntu, etc.).
Voordelen: Geen permanente installatiestap behalve de npm-cache; haalt altijd een recente gepubliceerde versie op; eenvoudigste onboarding. Nadelen: Vertrouwt op netwerk voor het initiële pakket; minder handig voor diepe source-inspectie of aangepaste builds.
Methode 2: Installeren en draaien vanaf source
Gebruik dit als je Cordis-plugins wilt lezen, een commit wilt pinnen, aangepaste presets wilt ontwikkelen of wilt bijdragen.
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
Dezelfde Web UI verschijnt op de standaardpoort. Developer-preview-builds kunnen tussen commits breken, dus behandel dit als een experimenteel pad.
Methode 3: Desktopapplicaties (geen Node-setup)
Community- en derdepartij-desktopwrappers verpakken de runtime zodat gebruikers geen Node/pnpm zelf hoeven te installeren:
- Op Tauri gebaseerde lichtgewicht clients die een gebundelde Node-runtime bootstrappen en bij launch de nieuwste upstream harness synchroniseren. Ze draaien op 127.0.0.1:3080, houden data lokaal en registreren dsh-commando’s.
- Electron-gebaseerde packaging die pinned dependencies bevat.
Download installers van de respectievelijke GitHub Releases-pagina’s (zoek op “deepseek-harness-desktop”). Bij de eerste start worden de kerncomponenten gedownload (een paar honderd MB). Handig voor niet-technische gebruikers maar geen officiële DeepSeek-producten—bekijk de repository en SHA-checksums.
Methode 4: Docker / container-deployment
Community Docker-images en compose-bestanden bestaan om de Web UI binnen een container te draaien, vaak met HTTPS-terminatie via nginx en ondersteuning voor willekeurige OpenAI-compatibele gateways. Typische flow:
Bash
git clone <docker-repo>
cd <docker-repo>
cp .env.example .env # set API key / public host
docker compose up -d --build
Handig voor LAN-toegang, servers of omgevingen waar Node niet gewenst is op de host. Sommige setups ondersteunen custom settings.yaml voor niet-DeepSeek-providers.
Methode 5: Python SDK voor programmatisch / headless gebruik
Voor unattended agents of integratie in Python-pijplijnen:
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
python -m pip install deepseek-harness-sdk
Stel omgevingsvariabelen in:
Bash
export DEEPSEEK_API_KEY=sk-your-key-here
# optional: export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1
# optional: export DSH_MODEL=deepseek-v4-flash
Voer vervolgens de mee ingecheckte voorbeelden uit of gebruik de DeepSeekHarness-klasse in je eigen code met een geïsoleerde workspace- en sessiedirectory. De SDK bundelt zijn eigen runtime en vereist geen systeem-Node.js.
Methode 6: Ollama-integratie
Ollama biedt een gemakkelijke launcher:
Bash
ollama launch dsh
# or with a specific model
ollama launch dsh --model deepseek-v4-flash:cloud
Ollama kan het pakket indien nodig installeren en slaat launch-instellingen apart op. Websearch- en toolondersteuning hangt af van het gekozen model en de Ollama-cloudtoegang.
Modellen en providers configureren (inclusief CometAPI)
Ga in de Web UI naar Settings → Models.
- Voor officiële DeepSeek: plak de sleutel van platform.deepseek.com. Typische modellen zijn deepseek-v4-flash en deepseek-v4-pro.
- Voor catalogusproviders (Anthropic, OpenAI, etc.): gebruik de “Add provider”-flow.
- Voor aangepaste / self-hosted / aggregator endpoints: kies “Add a custom provider.” Geef een permanente Provider ID, base URL, protocol (meestal openai-completions), API-sleutel-omgevingsreferentie of -waarde en ten minste één model-ID op.
CometAPI-aanbeveling (sterk aangeraden voor veel productie-achtige workflows) CometAPI is een uniform AI-infrastructuurplatform dat 500+ modellen (inclusief DeepSeek-varianten, GPT, Claude, Gemini, Grok en vele anderen) blootstelt via een enkel OpenAI-compatibel endpoint: https://api.cometapi.com/v1.
Voordelen bij gebruik met DeepSeek Harness:
- Eén API-sleutel in plaats van meerdere providercredentials beheren.
- Concurrerende prijzen (gerapporteerd 20–40% besparing ten opzichte van directe leveranciers tarieven voor veel modellen).
- Hoge beschikbaarheid (99,9% SLA-doel), lage mediane latency en pay-as-you-go-billing.
- Eenvoudig modelswitchen voor A/B-tests of kostenoptimalisatie zonder de harnessconfiguratie te wijzigen behalve de model-ID.
- Drop-in-compatibiliteit: bestaande OpenAI SDK-patronen werken na alleen het wijzigen van base_url en de sleutel.
In het custom-provider-formulier van de harness:
- Base URL:
https://api.cometapi.com/v1 - Protocol: openai-completions (of de equivalente ondersteunde optie)
- API-sleutel: je CometAPI-sleutel
- Model-ID: elke ondersteunde modelstring uit de CometAPI-modelcatalogus
Deze combinatie behoudt de krachtige lokale agent-runtime en biedt flexibele, kosteneffectieve, multi-vendor-modeltoegang. Nieuwe gebruikers krijgen doorgaans gratis testcredits. Documentatie: https://apidoc.cometapi.com/.
Sleutels worden write-only opgeslagen (bijv. onder $DSH_HOME/.credentials.yaml); de UI toont alleen geredigeerde descriptors.
Probleemoplossing voor DeepSeek Harness
DEEPSEEK_API_KEY niet gevonden
Controleer:
echo $DEEPSEEK_API_KEY
Op Windows:
echo $env:DEEPSEEK_API_KEY
Als leeg, configureer opnieuw.
400 reasoning_content-fout
Dit wijst meestal op onjuiste afhandeling van de reasoning lifecycle.
Controleer of je applicatie de relevante assistant reasoning-informatie behoudt over multi-turn thinking/tool-call requests heen.
Dit is een van de kernproblemen die de harness specifiek is ontworpen om te behandelen.
Contextlengte-fout
Controleer:
input tokens + max_tokens
Het gedocumenteerde harde plafond is:
1,048,576 tokens
Verlaag ofwel de inputcontext of de aangevraagde completiongrootte.
Tool-calls raken misvormd tijdens streaming
Ga er niet van uit dat stream-chunks in toolvolgorde aankomen.
Aggregeer tool-call-delta’s per tool_call.index, zoals aanbevolen door het harnesscontract.
Aanvragen zijn onverwacht duur
Controleer:
- thinking mode
- outputlengte
- cache-hit rate
- stabiliteit van de promptprefix
- modelkeuze
- huidige API-prijzen
Een eenvoudige verbetering is vaak om routinetaken van Pro naar Flash te verplaatsen.
Vergelijking van installatie- en deploymentmethoden
| Methode | Gebruiksgemak | Node vereist | Beste voor | Persistentie / controle | Typische poort / toegang | Opmerkingen |
|---|---|---|---|---|---|---|
| npx one-liner | Hoogst | Ja | Snelle trials, meeste gebruikers | Ephermeraal (alleen cache) | 3080 (configureerbaar) | Officieel aanbevolen |
| Source (pnpm) | Medium | Ja | Development, plugins, pinning | Volledige source control | 3080 | Vereist pnpm + build |
| Desktop (Tauri/Electron) | Hoog | Nee (gebundeld) | Niet-technische gebruikers | Lokale profielen & auto-update | 3080 (intern) | Community-packages |
| Docker | Medium | Nee (container) | Servers, LAN, HTTPS | Containervolumes | Custom / 443 | Community-images |
| Python SDK | Medium | Nee (gebundeld) | Headless, automatisering, pipelines | Programmatische sessies | N.v.t. (geen UI standaard) | Officiële SDK |
| Ollama launch | Hoog | Optioneel | Lokale-model-experimenten | Ollama-instellingen | 3080 | Integreert met Ollama |
Gegevens gesynthetiseerd uit officiële docs en post-launchgidsen (augustus 2026).
Conclusie en volgende stappen
DeepSeek Harness brengt een helder ontworpen, volledig plugin-based agent-runtime naar lokale machines met vrijwel geen frictie via de npx one-liner. Gecombineerd met flexibele modelrouting—zeker via een uniform platform zoals CometAPI—krijg je zowel de kracht van moderne agentische coding-workflows als praktische controle over kosten, modelkeuze en datalocaliteit.
Begin vandaag met:
npx @deepseek-ai/dsh web
Configureer een DeepSeek- of CometAPI-sleutel, wijs het naar een veilige workspace en verken de Standard-modus. Experimenteer daarna met Minimal-modus voor benchmarks, custom providers voor kostenoptimalisatie of de Python SDK voor automatisering.
Voor de nieuwste officiële instructies geef altijd de voorkeur aan de GitHub-repository en doc. Voor multi-modelbetrouwbaarheid en prijsvoordelen tijdens gebruik van de harness, verken CometAPI en de documentatie op https://apidoc.cometapi.com/.


