DeepSeekDSH
Fix an error中文GitHub
Menu
Independent community guideNot affiliated with DeepSeek.
HomeTutorials

Install DeepSeek Harness from scratch

Pick your operating system, complete the shortest supported setup path and verify the workspace before asking DSH to change files.

Maintained by DeepSeekDSH (independent site)Documentation review
On this page
Start with the shortest path that fits your system

Windows x64 and Apple Silicon beginners can use the official DeepSeek Harness Desktop preview. Intel Mac and Linux use the official npm/npx path. In every case, use an empty test folder before pointing DSH at an important repository.

Have a network connection and a model-provider credential ready. The installer does not include model API credits. You can use the DeepSeek setup guide or the provider library below.

Choose your operating system

Each guide ends at the same checkpoint: DSH opens, a model is configured and a read-only workspace test succeeds.

Prepare the model account you will connect

Installing DSH and connecting a model are separate steps. Use the guide for the provider that issued your API key.

Connect a DeepSeek API keyPrepare the key, save the credential and select a modelUse another model providerFind the official key page, protocol, model-selection steps and failure checks

After DSH opens, complete these three checks

01

Configure a model

Open Settings → Models, save your provider credential and select a model from the live picker.

02

Choose an empty test folder

Create a disposable dsh-test folder and select it with Choose workspace.

03

Verify before editing files

Ask DSH to report the workspace path and list its files without creating, editing or deleting anything.

Read-only verification prompt
Use tools to report the full path of the current workspace and list the files in it. Do not create, edit or delete any files.

Compare the tool result with the folder on your computer. An empty file list is valid for an empty folder. A conversational reply alone does not verify workspace access.

The basic setup is complete when all three checks pass

DSH opens normallyThe Desktop window or local Web UI is available
The model repliesNo missing-credential or unknown-model error
The workspace is correctThe reported path and file list match dsh-test on disk

If one check fails, fix that layer before asking DSH to edit files. Start with model configuration or the troubleshooting guide.

What to learn after the setup works

Run a controlled first taskRead repository facts, make one small change and verify the result on diskChoose a session presetStandard, PTC, Minimal and Creator are different tool compositions, not model rankingsAdd an extension only when the task needs itCheck source, install behavior and requested access before adding a plugin

Advanced setup and failure paths

Windows CLI setupNode.js → npx → local Web UI → port troubleshootingmacOS CLI setupNode.js → Terminal → npx → local Web UIRun from sourceFor development, debugging or pinned repository dependenciesCustom providerCompany gateway, self-hosted endpoint or non-catalog providerPlugin installationReview source, install dependencies, restart and verifyProxy and networkUse this for download failures, timeouts or corporate network requirements
Sources and download records

DeepSeek Harness official repository, Official Desktop documentation, Desktop download page.

Use the current download links on the official DeepSeek Harness page. Links checked: . The Desktop download page lists historical installers separately.