← Back to all projects

deepseek-harness

DeepSeek AI's own agent harness: everything is a plugin, run behind a local Web UI on the Cordis runtime.

OfficialMIT
Stars
267k
Forks
32.3k
Open issues
0
Last commit
30 Oct 2026

What is deepseek-harness?

`dsh` is the agent harness DeepSeek AI develops itself. `npx @deepseek-ai/dsh web` brings up a Web UI on `http://127.0.0.1:3080`, and the architecture behind it is one where everything is a plugin, powered by the Cordis runtime, so it suits people who intend to extend a harness rather than only operate one. The caveat comes from the project itself: it is labelled a developer preview and warns in capitals that there will be compatibility-breaking changes, so plugins written today should budget for rework. It is also a poor fit if you want a documented scripted or embedded entry point right now, since the README covers only the `web` command and a source checkout, and links out to a development guide and architecture documentation without saying what either contains.

What can you do with deepseek-harness?

  • Get a Web UI running from one command — With Node.js installed, npx @deepseek-ai/dsh web starts the harness and serves its Web UI at http://127.0.0.1:3080 by default.
  • Build on the plugin architecture — The harness is powered by the Cordis runtime under an everything-is-a-plugin architecture; the README's Development section points at a development guide (docs/development.md) and architecture documentation (docs/architecture.md).
  • Make your plugin discoverable — Adding the dsh-plugin GitHub topic to a plugin repository is the route the README gives for discoverability, with feedback and bug reports going through GitHub Discussions or the project's Discord. Those are the only routes: Issues are switched off on the repository, so there is no public backlog to read before adopting — no way to see what breaks, how long it stays broken, or whether maintainers reply. For a developer preview promising compatibility-breaking changes, that is the thing to weigh.
  • Run and modify the harness from source — Clone the repo, then pnpm install, pnpm run build and pnpm dsh web to launch your own checkout instead of the published package.
  • Hand the repo to a coding agent — The README directs agents working in this codebase to follow AGENTS.md at the repo root.

Star history

16 Aug to 30 Oct · +137k

130k267k

Frequently asked questions

Is deepseek-harness free for commercial use?

deepseek-harness is released under the MIT licence — OSI-approved open source, which permits commercial use.

How can deepseek-harness be deployed?

deepseek-harness is available as Self-hosted / Runs locally.

deepseek-harness
Ask AI
GitHub