251.2K ·GitHub
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.
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.
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.
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.
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.
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.
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'.
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.
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.
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.
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
dsh-router-standard, oh-dsh, dsh-plugin-bridge, dsh-lowtide, awesome-deepseek-harness, cocode, acryl, awesome-deepseek-harnessWhich topics is it in?cordis, plugins, agent-harness, ai-tools, architecture, dsh, harness, autonomous-agents, dsh-plugin, deepseek-harness, deepseek, plugin
cordis, plugins, agent-harness, ai-tools, architecture, dsh, harness, autonomous-agents, dsh-plugin, deepseek-harness, deepseek, plugin