deepseek-harness README

The project's README from github.com/deepseek-ai/deepseek-harness. As one markdown file: README.md.

DeepSeek Harness

English | 中文

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, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

Documentation: https://deepseek-harness.github.io/deepseek-harness/

Developer preview

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

Review the safety notice before running the project.

Run

Run from npm

Install Node.js, then run:

npx @deepseek-ai/dsh web

The command starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch. An SSH launch only prints the host URL because the SSH client or editor owns the local forwarded address. Pass --no-open to run the server without opening a browser. 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

pnpm run build prepares the repository artifacts. pnpm dsh web uses those built artifacts without rebuilding.

Community and support

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

pnpm run dev:web builds, serves, and rebuilds client bundles on source edits in one terminal, and make help lists the matching Make targets for Web and Desktop; the guide's application commands section owns the full table.

For agents, follow AGENTS.md.

Citation

@misc{deepseek-harness2026,
  title={DeepSeek Harness: Everything is a Plugin},
  author={DeepSeek-AI},
  year={2026},
  publisher={GitHub},
  howpublished={\url{https://github.com/deepseek-ai/deepseek-harness}},
}

License

MIT

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

deepseek-harness (deepseek-ai/deepseek-harness)

linux
Searching Database…

252.1K ·GitHub
Deepseek-harness
What is this?DeepSeek Harness (dsh) is an open-source agent harness from DeepSeek AI, built entirely on an everything-is-a-plugin architecture and powered by the Cordis composability engine.
Is this a framework I code against, or a standalone program I run?It is a runnable harness: starting dsh spins up a local server with a Web UI, and literally everything inside it, including the UI, is implemented as a swappable plugin on top of the Cordis engine.
How do I get it running?Install Node.js, then run dsh from npm; it starts a server and opens the Web UI in your browser automatically. To run from a source checkout instead, use pnpm run build and then pnpm dsh web.
What do I need installed before trying it?Only Node.js (version 22.19.0+ or 24.0.0+); building from a repository checkout additionally needs pnpm to compile the artifacts first.
Is it stable enough to build on right now?No, it is explicitly a developer preview that is iterating rapidly, and the maintainers warn there will be compatibility-breaking changes, so you should read the safety notice before running it.
Who is this aimed at?Plugin authors and agent builders extending DeepSeek's harness; the project even asks plugin maintainers to tag their own repos for discoverability.
What is Cordis?Cordis is the composability engine that powers dsh's plugin architecture; its design is documented in the paper 'A Programming Paradigm for Spatiotemporal Composability'.
Does it behave differently if I run it over SSH?Yes, over an SSH session it only prints the host URL instead of opening a browser, since the SSH client or editor owns the forwarded local address. You can also pass --no-open on any machine to skip the browser launch.
Is there more than just a Web UI?The build scripts include a separate build:desktop target alongside build:web, suggesting a desktop client is being developed alongside the browser-based Web UI.
Why tag a repo with dsh-plugin?It is the convention DeepSeek Harness uses so plugin authors can make their community plugins discoverable to other dsh users.
What are similar projects?dsh-router-standard, oh-dsh, dsh-plugin-bridge, dsh-lowtide, awesome-deepseek-harness, cocode, acryl, awesome-deepseek-harness
Which topics is it in?cordis, plugins, agent-harness, ai-tools, architecture, dsh, harness, autonomous-agents, dsh-plugin, deepseek-harness, deepseek, plugin
Creator
deepseek-ai
Size
285.8 MB
Stars
252.1K
Updated
CommitOct 17
Age
2mo
Commits · 90 Days