Home›DeepSeek DSH

Install DeepSeek Harness with npx

Run the official quick-start command, check your Node.js version, then configure a model and workspace in the local DSH Web UI.

On this page

Run DeepSeek Harness with npx

npx @deepseek-ai/dsh web

This official quick-start command starts the local DeepSeek Harness Web UI. Keep this terminal open while you use DSH; stop the server with Ctrl+C when you finish.

What you need

Install a supported release from the official Node.js download page. The verified DSH source declares ^22.19.0 || >=24.0.0: Node 22.19 or newer within the 22.x line, or Node 24 and later. Node 20 and 23 do not satisfy that range.

Check which Node.js and npm your terminal actually uses:

node --version

npm --version

The npm quick-start does not require cloning the GitHub repository or running pnpm install.

You will also need a credential for the model provider you choose. A DeepSeek key is one option; the API setup guide explains the built-in DeepSeek route.

What happens after the command starts?

DSH starts a local Web UI. The official default address is:

http://127.0.0.1:3080

Use the address printed by your process if it differs. A local launch normally opens the browser; npx @deepseek-ai/dsh web --no-open starts the server without doing so.

An open page confirms that the Web server started. To send a first request, save a provider credential in Settings → Models, select a model, then add and select a test workspace. Follow the first Web UI task guide to verify the result.

Common errors

node, npm or npx is not recognized

Install Node.js, reopen the terminal and run the version checks again.

EBADENGINE or an unsupported Node.js version

Compare node --version with the supported range above. Switch to a supported Node version, reopen the terminal and check again before restarting DSH.

127.0.0.1:3080 does not open

Check the terminal first. If the DSH process exited, read its last error message before running the command again. For EADDRINUSE, EACCES or connection failures, use the startup troubleshooting guide.

Continue with the maintained guides

Choose a desktop or CLI installation pathWindows, macOS and Linux setup options Run your first Web UI taskChoose a workspace and verify the result

Sources

Official quick start · Node.js engine range in the verified source snapshot. Check the package requirements again when choosing a different DSH version.