dshbase

Install

Install DeepSeek Harness (dsh)

DeepSeek Harness is a Node.js package — the only requirement is Node.js. Pick your system for a one-line install, or build from source.

Before you start

  • You need Node.js LTS (18+) — every script below checks for it first.
  • DeepSeek Harness is in developer preview — iterating fast, breaking changes will come.

Windows — one line (PowerShell)

Open PowerShell (right-click Start → Terminal) and paste:

if (-not (Get-Command node -ErrorAction SilentlyContinue)) { winget install OpenJS.NodeJS.LTS }
npx @deepseek-ai/dsh web

If winget isn't available, install Node.js manually from nodejs.org (LTS installer), then run npx @deepseek-ai/dsh web.

macOS — one line (Terminal)

command -v node >/dev/null 2>&1 || brew install node
npx @deepseek-ai/dsh web

If you don't have Homebrew, install it first, or grab Node.js from nodejs.org.

Linux — one line (bash)

Debian / Ubuntu (uses NodeSource):

command -v node >/dev/null 2>&1 || (curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs)
npx @deepseek-ai/dsh web

Other distros, or to avoid sudo, use nvm then npx @deepseek-ai/dsh web.

WSL (Ubuntu on WSL) — one line

Inside your WSL Ubuntu terminal:

command -v node >/dev/null 2>&1 || (curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs)
npx @deepseek-ai/dsh web

Build from source (all platforms)

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

Uses pnpm — install with npm install -g pnpm if you don't have it.

Verify it's running

Open http://127.0.0.1:3080 and enter your DeepSeek API key. To use a different port, pass it to the app:

npx @deepseek-ai/dsh web --port 8080

What to do next

  1. Follow the tutorial to configure a model and run your first task.
  2. Add your DeepSeek API key under Settings → Models.
  3. Build your own plugins with the plugin guide.
🌐 中文