DeepSeek Harness

English | 中文

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.

It uses an architecture where everything is a plugin, and is powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

Developer preview

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Run

Run from npm

Install Node.js, then run:

npx @deepseek-ai/dsh web

The command starts the Web UI, served at http://127.0.0.1:3080 by default. See Web UI guide.

Run from source

To run from a repository checkout:

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

Run the Minimal + CLI bus distribution

This community distribution preserves Minimal's fixed prompt and two native tools while making host adapters available through dshx inside persistent Bash. Native Windows is not supported by the current persistent-terminal provider; use Linux, macOS, or WSL.

git clone https://github.com/sindo-s/deepseek-harness-cli-bus.git
cd deepseek-harness-cli-bus
pnpm run setup:minimal-cli-bus
pnpm run dsh:minimal

The setup command installs dependencies, builds the workspace, and links the source checkout's dshx executable. dsh:minimal starts the Web UI with Minimal selected for new sessions; no manual symlink or PATH edit is required.

Community and support

• Feel free to submit feedback or bug reports through GitHub Discussions.
• Add the dsh-plugin topic to your plugin repository for discoverability.
• Join DeepSeek Harness Discord community.

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

For agents, follow AGENTS.md.

License

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.