Command generator

Choose your install path

local only
Keep the process and workspace in the same environment.
Quick start is the current official entry path.
PowerShell · quick start
node --version
npm --version
npx @deepseek-ai/dsh web

Expected default address: http://127.0.0.1:3080

Check the environment before the package

Run Node and npm checks in the exact shell that will launch DSH. The current npm package does not publish a Node engines floor, so this page does not invent one. Keep the repository and DSH process in the same native, WSL, container, or remote environment.

Verify five boundaries

  1. Runtime: Node and npm resolve in the intended environment.
  2. Process: DSH stays running and prints a URL.
  3. Browser: the printed address opens; the documented default is 127.0.0.1:3080.
  4. Configuration: a model credential can be saved and a workspace selected.
  5. Task: a small read-only repository summary completes before broader permissions.

Use a safe first task

The official Web UI guide recommends a repository summary task after model and workspace selection. It exercises file reading without asking the agent to modify the repository.

First task · prompt
Summarize this repository and identify its main packages.

Do not reinstall before locating the failure

Visible symptomFirst boundary to inspect
Package command fails immediatelyNode/npm resolution, registry access, package name, and current CLI output.
Process exitsFirst error line, port conflict, configuration parse, and recent update.
Browser cannot connectPrinted host/port and native/WSL/container boundary.
Composer is blockedModel selection and workspace selection.
Model request failsCredential, provider, exact model ID, and endpoint response.

Open the symptom-led troubleshooting hub →

Primary sources