deepseek-ai/deepseek-harness

deepseek-ai/deepseek-harness

Description: DeepSeek Harness: Everything is a Plugin.

Language: TypeScript

License: MIT

Stars: 75478

Forks: 6490

Open issues: 0

Created: 2026-08-13T11:56:32Z

Pushed: 2026-08-13T13:00:21Z

Default branch: master

Fork: no

Archived: no

README:

DeepSeek Harness

English | [中文](README.zh.md)

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](docs/user/guide/index.md).

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

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](CONTRIBUTING.md).

Development

Start with the [development guide](docs/development.md) and [architecture documentation](docs/architecture.md).

For agents, follow [AGENTS.md](AGENTS.md).

License

[MIT](LICENSE)

Third-party dependencies and their licenses are disclosed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).