DeepSeek Harness

DeepSeek Harness is the agent runtime behind DeepSeek's frontier model scores — the layer of tools, memory, sub-agent orchestration, and termination logic that sits on top of a model and turns it into a working agent. It debuted publicly on July 31, 2026, when DeepSeek ran the DeepSeek-V4-Flash agent benchmarks in Harness minimal mode, and the code went open source (MIT) on August 13, 2026 under the motto "Everything is a Plugin." If you want to reproduce DeepSeek's reported benchmark numbers or build your own DeepSeek-powered coding agent, this is the harness to use.

Key Features

• Plugin-Based Architecture: Every capability — tools, memory, sub-agent orchestration, termination logic — is a plugin. The repo's motto is "Everything is a Plugin," and plugins ship as versioned packages you can mix, match, and write yourself.
• Model + Harness = Agent: Designed around the equation that an agent is a model plus a harness. The harness handles terminal use, file operations, web access, and code execution so the model can focus on reasoning.
• Minimal Mode: The constrained tool set DeepSeek used to evaluate V4-Flash — terminal, file I/O, web, and code execution — shipped first to prove the model's agentic capability before the full runtime.
• Sub-Agent Orchestration: Built-in mechanisms for spawning, supervising, and collecting results from child agents, with termination logic to stop runaway loops.
• Memory & Context Management: Cache-friendly context handling that keeps long agent sessions affordable on DeepSeek's prefix-cache pricing.
• TypeScript Native: Written in TypeScript and distributed via the @deepseek-ai/dsh npm package — launch the Web UI with npx @deepseek-ai/dsh web.
• DeepSeek-Native Economics: Purpose-built to run on DeepSeek models with their 1M-token context and cache-hit pricing, though it works with any model provider.

Use Cases

Who Should Use This Tool?

• Agent Builders: Developers who want the same harness that produced DeepSeek's 82.7 Terminal Bench 2.1 and 54.4 DeepSWE scores.
• DeepSeek Power Users: Teams running coding agents on V4-Flash and V4-Pro who want a first-party harness instead of third-party wrappers.
• Benchmark Reproducers: Researchers and engineers who want to independently verify DeepSeek's agent benchmark claims.
• Open-Source Contributors: Developers interested in contributing to a fast-moving, well-funded agent framework.

Problems It Solves

1. Vendor lock-in to proprietary agents: An MIT-licensed harness you can fork, audit, and self-host, unlike Claude Code or Codex.
2. The "model is bad at tool calling" myth: DeepSeek argues poor agent behavior is usually a harness problem, not a model problem — this is their reference implementation.
3. Non-reproducible benchmarks: Since the benchmark configuration (minimal mode, max effort, top_p 0.95, temperature 1.0) is now public, results can actually be checked.

Pricing

Underlying model pricing (USD per 1M tokens, as of Aug 2026):

Advantages & Unique Selling Points

Compared to Competitors:

1. First-party harness: DeepSeek's own runtime, tested at frontier scale — versus third-party harnesses that bolt onto the API.
2. Radically cheaper: V4-Flash at $0.14/$0.28 per 1M tokens runs agentic workloads at a fraction of Claude Opus or GPT-5.5 cost.
3. MIT open source: Full transparency and forkability, unlike the proprietary agents from Anthropic or OpenAI.

What Makes It Stand Out:

• The harness behind the July 31, 2026 V4-Flash agent scores: Terminal Bench 2.1 (82.7), NL2Repo (54.2), Cybergym (76.7), DeepSWE (54.4), Toolathlon verified (70.3).
• 24,000+ GitHub stars within hours of the open-source release.
• Built by a dedicated DeepSeek team since March 2026, with the full product expected to evolve into "DeepSeek Code" — DeepSeek's answer to Claude Code.

User Reviews

"The insight that 'open model bad at tool calling' is almost always a harness problem, not a model problem, is exactly right. This is the reference implementation we've been waiting for." — Hacker News discussion on DeepSeek Harness

"10-12x cheaper than the frontier closed agents while landing near Claude Opus on agent benchmarks. The economics are the story." — Reddit r/LocalLLaMA comment

"Finally an official harness to reproduce DeepSeek's numbers. Vendor-reported scores become checkable." — Hacker News comment

Getting Started

Quick Start Guide

1. Clone: git clone https://github.com/deepseek-ai/deepseek-harness
2. Install: Follow the repo README to install dependencies (TypeScript-based, npm ecosystem).
3. Configure: Add your DeepSeek API key (or any provider) and select plugins.
4. Run: Launch the Web UI with npx @deepseek-ai/dsh web, or run headless in your project directory.

Integration

Integrates with:

• DeepSeek API (V4-Flash, V4-Pro) and the Responses API
• Codex workflow compatibility
• Plugin packages via the dsh-plugin ecosystem
• MCP-style tools through its plugin interface

Frequently Asked Questions

Is DeepSeek Harness free?

Yes — the harness is MIT-licensed open source. You only pay for model API usage through DeepSeek's platform.

Which models does it support?

It is built for DeepSeek's V4-Flash and V4-Pro models with 1M-token context, and the plugin architecture means other providers can be added.

Can I reproduce DeepSeek's benchmark scores?

The public benchmark configuration is now documented: Harness minimal mode, max effort level, top_p 0.95, temperature 1.0. Independent reproduction is in progress as of August 2026.

How does it compare to Claude Code?

Claude Code is proprietary; DeepSeek Harness is MIT-licensed, self-hostable, and runs on models that cost roughly 10x less per token. Feature parity on the full "DeepSeek Code" product is still evolving.

Alternatives

If DeepSeek Harness isn't the right fit, consider these alternatives:

• Claude Code: Anthropic's proprietary coding agent, the UX benchmark DeepSeek is targeting.
• Reasonix: Third-party DeepSeek-native terminal agent tuned for prefix-cache economics.
• OpenAI Agents SDK: OpenAI's open-source agent framework with a different orchestration model.

Tips & Best Practices

1. Use cache-friendly prompts: DeepSeek's cache-hit pricing ($0.0028 vs $0.14 per 1M input) rewards stable, append-only contexts — keep your harness sessions long-running.
2. Start with minimal mode: Run the exact configuration DeepSeek used for benchmarks before adding heavy plugins.
3. Watch peak pricing: From August 16, 2026, DeepSeek introduces peak/off-peak rates (UTC 01:00–04:00 and 06:00–10:00 are peak) — schedule batch agent runs off-peak.

Conclusion

DeepSeek Harness is the open-source agent runtime that produced DeepSeek's frontier agent scores — plugin-based, MIT-licensed, and priced to make agentic workloads run at a fraction of closed-agent cost. If you build agents on DeepSeek models, or want to reproduce — and maybe beat — the numbers behind V4-Flash, this is the reference harness to start from.