Install & Get Started

Boot DeepSeek Harness with npx @deepseek-ai/dsh, add your first DSH plugin via dsh plugin --profile web add, then restart dsh web and run it. Building from source suits developers who need to modify the code.

This category covers the full DeepSeek Harness Plugin installation path: the npx one-liner, cloning and building from source, adding DSH plugins to a profile, and verifying with dsh --dump-config. You need Node.js; after installing, launch the Web UI with dsh web or run headless. Commands are cross-platform with differences called out.

DSH-Plugin tutorial list

DSH installation FAQ

What environment does DSH require?

Node.js. The npx method needs nothing else; source builds also need Git and pnpm. Before adding a DSH plugin, check it is compatible with your DSH version.

What is the difference between npx and building from source?

npx fetches the latest published package temporarily with no global install — uninstall just removes ~/.dsh. Building from source clones deepseek-ai/deepseek-harness and compiles it, which suits debugging and contributing, but requires pnpm run build first.

How do I install my first DSH plugin?

Run dsh plugin --profile web add <package or Git URL>; the command forwards arguments to that profile's pnpm, then restart dsh web for it to take effect. Start with the web profile, which has a built-in init template.

How do I verify a plugin installed correctly?

Run dsh --dump-config to inspect the merged config tree, then dsh plugin --profile web why <package> to check dependencies; after that launch dsh web and the plugin's capabilities appear in the Web UI.

Will installing DSH break my existing Node.js environment?

No. npx fetches into a temporary directory and source builds compile only inside the clone; DSH data and config live in ~/.dsh by default, so your global environment stays untouched.