Explore DeepSeek Harness on GitHub

Explore DeepSeek Harness open-source repository on GitHub. Track latest releases, Cordis plugin architecture, and Agent benchmark updates.

Core Project Pillars

Model + Harness = Agent Paradigm

Decouples base reasoning LLMs from execution scaffolding. Deeply integrates unambiguous TypeScript tool contracts, high-throughput bash execution engines, and precision multi-chunk code diff replacement algorithms.

Containerized Docker Sandboxing

All shell commands and multi-file code refactorings execute safely inside lightweight Docker container sandboxes with strict hardware limits on CPU, memory, and disk I/O for dependable and risk-free operations.

DSBench & Automated Self-Correction

Built-in automated pytest integration and compiler error log stack trace extraction. Evaluates Pass@1 benchmarks via DSBench and LM-Eval suites to continuously trigger autonomous agent self-correction loops.

DeepSeek Prefix Cache Optimization

Deeply aligned with DeepSeek-V3/R1 native Prefix Caching mechanisms, achieving up to 99.93% prefix cache hit rates across multi-turn complex repository edits and reducing Token compute costs by 80%+.

DeepSeek Harness Logo

deepseek-ai

DeepSeek Official Infrastructure

DeepSeek Harness is an industrial-grade AI agent execution framework crafted by the DeepSeek engineering team. The GitHub repository hosts open-source agent scaffolding, tool contracts, and DSBench benchmark runner suites.

Visit Official Repository

Installation & Setup Guide

Follow step-by-step instructions to run DeepSeek Harness via npx one-click commands, build from GitHub source, or launch custom preset modes.

Environment Preparation

01

Ensure Node.js (>= 18.0.0) and Git are installed. Optionally start Docker Desktop to enable isolated container sandboxing.

node -v && git --version

One-Click Launch via npx (Recommended)

02

No manual build required. Run this command in your terminal to launch the interactive Web UI in your default browser.

npx @deepseek-ai/dsh web

Clone GitHub Source for Custom Development

03

Ideal for developing custom Cordis plugins, expanding agent toolsets, or connecting private LLM API endpoints.

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
npm install
npm run dev

Specify Preset Agent Modes

04

Easily switch between Standard, PTC, Minimal, and Creative preset modes via CLI flags.

# Programmatic Tool Calling (TypeScript Code Mode)
npx @deepseek-ai/dsh --mode ptc

# Minimal Dual-Tool Mode (For Noise-Free Benchmarks)
npx @deepseek-ai/dsh --mode minimal

# Creative Mode (In-Memory Plugin Testing)
npx @deepseek-ai/dsh --mode creative
Need help or custom plugin documentation? Visit the official developer guide.
Read Official Docs