Repo Agents Limited info

deepseek-ai/deepseek-harness

Open-source agent harness (dsh) from DeepSeek AI built on an everything-is-a-plugin architecture with Cordis; includes a Web UI. Developer preview.

  • 246k GitHub stars
  • TypeScript
  • ⚖️ MIT
  • 🎯 Intermediate
View on GitHub (opens in a new tab) Setup guide
npx @deepseek-ai/dsh web
deepseek-ai/deepseek-harness preview image

What it is

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI. It is built on an everything-is-a-plugin architecture and powered by Cordis. It can be launched via npx or from a source checkout, and starts a Web UI at http://127.0.0.1:3080 by default. The project is in developer preview.

Who it's for

  • Developers who want to run or experiment with an agent harness from DeepSeek AI
  • Plugin authors who want to build plugins for dsh and make them discoverable via the dsh-plugin topic
  • Contributors interested in the architecture and development of the project

Requirements

Requirements

  • Node.js (for running via npx)
  • pnpm (for running from source)
  • git (for cloning the repository)
  • Review the safety notice (SAFETY.md) before running the project

Setup

  1. Run from npm

    Install Node.js, then run the command. It starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch. Pass --no-open to run the server without opening a browser.

    bash
    npx @deepseek-ai/dsh web

  2. Run from source

    From a repository checkout, install dependencies, build, and start the Web UI. pnpm run build prepares the repository artifacts; pnpm dsh web uses those built artifacts without rebuilding.

    bash
    git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Examples

Launch the Web UI via npx

bash
bash
npx @deepseek-ai/dsh web

What it does: Starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser on a local launch.

Run from a repository checkout

bash
bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

What it does: Builds the repository artifacts and starts the Web UI from source.

Pros & cons

Pros

  • Pro:Everything-is-a-plugin architecture built on Cordis
  • Pro:Quick start with a single npx command
  • Pro:MIT licensed, with third-party licenses disclosed
  • Pro:Plugin discoverability supported through the dsh-plugin GitHub topic

Cons

  • Con:In developer preview with explicitly warned compatibility-breaking changes
  • Con:Requires reviewing a safety notice before running

Images

deepseek-ai/deepseek-harness preview image
deepseek-ai/deepseek-harness preview image · deepseek-ai/deepseek-harness on GitHub · MIT
deepseek-ai/deepseek-harness preview image