Install DeepSeek Harness (dsh)

Official zero-install entry from the deepseek-harness README: npx @deepseek-ai/dsh web

Global install from the same README path: npm install -g @deepseek-ai/dsh, then run dsh web.

On npm, dist-tags follow the versions listed in this directory’s dsh package data (verify on npm before you pin). Pin a version if you need reproducible installs.

Official package and source live at github.com/deepseek-ai/deepseek-harness (apps/cli).

Checked on 26 Oct 2026 against deepseek-ai/deepseek-harness.

Official sources

Requirements

Node.js ^22.19.0 || >=24.0.0 per the repository package.json engines field. Review the project SAFETY.md before running Harness.

Install

How do I install dsh with npm? Run npm install -g @deepseek-ai/dsh, then dsh web. The official README also documents a zero-install path:

Official npm entry (verbatim)
npx @deepseek-ai/dsh web

Default Web UI URL: http://127.0.0.1:3080. Pass --no-open to skip opening a browser.

Choose a channel

  • latest → 0.2.1-rc.5 (pre-release rc, not stable GA)
  • next → 0.2.1-rc.5 (newer rc pre-release)
  • alpha → 0.2.2-alpha.3 (alpha pre-release)
Pin a specific version
npm install -g @deepseek-ai/dsh@0.2.1-rc.5
dsh web

Run from source

Official repository checkout commands:

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

Configure API key and model

Set your DeepSeek API key in the Harness profile or environment variables documented in the CLI README. Use API model names deepseek-flash and deepseek-v4-pro per the current API docs (migration guide).

Verify it works

Version check
npx @deepseek-ai/dsh --version

Update and uninstall

Update global install
npm install -g @deepseek-ai/dsh@latest
npm uninstall -g @deepseek-ai/dsh

Remember: @latest currently resolves to a release candidate, not a stable major release.

FAQ

Run npm install -g @deepseek-ai/dsh, then dsh web — or use npx @deepseek-ai/dsh web without a global install.

Both commands are documented in the official apps/cli README. Node.js ^22.19.0 or >=24.0.0 is required per the repository package.json engines field.

No. dist-tag latest is 0.2.1-rc.5, which is a release candidate pre-release.

Ensure your global npm bin directory is on PATH, or use npx @deepseek-ai/dsh web without a global install.

Current npm dist-tags: latest → 0.2.1-rc.5, next → 0.2.1-rc.5, alpha → 0.2.2-alpha.3.

Configure your DeepSeek API key and model in dsh profiles; API docs use deepseek-flash and deepseek-v4-pro today.