Choose the install path
Desktop and CLI have separate instructions. Check your operating system and chip; do not mix installation environments.
Choose your systemIndependent DeepSeek Harness guides
Get started with DeepSeek Harness
Connect a model to read files, edit code and run tools in your chosen workspace. Follow a clear path from installation to your first verified task.
Windows · macOS · LinuxSeparate Desktop and CLI guides
Desktop build linked here0.1.7-rc.1.20260924.1
Download record date
Supported filesWindows x64 · Apple Silicon
Before upgradingCompare installer, npm and guide versions
Get to a verifiable first session
Check installation, model connectivity and task results separately.
Configure and connect a model
Save provider credentials in local settings and select an available model. Installers do not include model API credits.
Connect a modelVerify a small task
Use a disposable workspace without secrets. List files first, verify the path, then permit changes only when intended.
Verify your first task
DSH Desktop · Windows / macOSUse the desktop package or follow the CLI path
The links below target Windows x64 and Apple Silicon. Review the download record and platform notes before running an installer.
Check Desktop versions and compatibility →Install for your operating system
Desktop, npx and global CLI prerequisites are explained separately.
Windows
Use the Windows x64 Desktop installer, or the PowerShell CLI section when needed.
Open installation guide →
macOS
The linked DMG is for Apple Silicon; Intel Mac users can follow the CLI path.
Open installation guide →
Linux
Prepare Node.js, start the local Web UI with npx, then verify the model and test folder.
Open installation guide →What is DeepSeek Harness (DSH)?
DSH brings models, sessions, workspaces, tool permissions and plugins into an executable workflow. When you choose a cloud model, requests are sent to its provider.
Understand the tool boundaries
Check the workspace, approvals and actual results when reading files, editing code or running commands.
Read the DSH overview →DSH and other coding tools
Compare model choice, tool access and extensibility rather than a single leaderboard.
Compare agent workflows →What do you need to solve next?
Fix a connection or setup error
Follow the exact error to check credentials, model configuration, ports or permissions.
Open the guide →
Configure models and understand costs
Set up the provider first, then review pricing assumptions, retries and task acceptance.
Open the guide →
Add plugins, MCP or messaging
Start with a working session, then check extension sources, installation paths and access boundaries.
Open the guide →Common DSH errors
Start with the exact message you see.
MISSING_CREDENTIALNo usable credential is saved for the provider.UNKNOWN_MODELThe selected model is not available under the configured provider.401 authentication failedThe provider rejected authentication for the request.EADDRINUSE / EACCES :3080The local port is occupied or reserved by the operating system.Select model / input disabledA provider, model or workspace still needs to be selected.npm.ps1 cannot be loadedPowerShell blocked the npm or npx script shim.Workspace permission deniedOperating-system or tool permissions blocked the file operation.Verify the workspace before changing a real project
Choose a test folder, configure the model, review approvals and inspect actual files.
Models and costs
Separate provider specifications, calculation assumptions and measured results.
Open the articles →Reproducible task and benchmark template
Start with a small repair task and record the environment, tests and costs. These are templates, not unrun model rankings.
Open the task and template →Version records and evidence
Distinguish linked downloads from historical references; old records are not current checks.
Open version records →