DeepSeek Harness Desktop

A native desktop launcher for DeepSeek Harness on Windows, macOS, and Linux.

Download · Report an issue

English · 简体中文

DeepSeek Harness Desktop is a community-maintained distribution project. It is not an official DeepSeek AI product.

DeepSeek Harness Desktop packages the DeepSeek Harness web experience as a native desktop application. It bundles the required Node.js runtime, starts DSH locally, and opens the interface in a dedicated desktop window.

Download

Download supported packages from GitHub Releases.

All current and historical packages are available from GitHub Releases.

Screenshots

Start a new workspace conversation with model and permission controls.

Choose a built-in Agent preset or create a custom preset.

What it provides

• Native startup — installs and launches DeepSeek Harness on Windows, macOS, and Linux without a separate Node.js installation.
• Local DSH runtime — starts DSH on a randomly assigned loopback port and renders it in an Electron window.
• Focused desktop workflow — uses the existing DSH workspace, session, model, plugin, and Agent preset capabilities.
• Desktop behavior — single-instance protection, system-tray controls, and safe handling of external links.
• Continuity with DSH CLI — reuses the current user's DSH home directory, including existing settings and sessions.

Requirements

Install and get started

1. Download the package for your operating system from Releases.
2. Run the Windows .exe installer, open the macOS .dmg, run the Linux .AppImage, or install the Debian/Ubuntu .deb package; then launch DeepSeek Harness Desktop.
3. Wait for the local DSH service to start, then create or open a workspace and session.
4. Configure models, plugins, permissions, and Agent presets in DSH settings as needed.

The installer bundles a complete runtime. Installation and first startup can take several minutes on some machines; allow the process to finish before cancelling.

Privacy and security

• The launcher accepts and loads only validated local HTTP addresses on 127.0.0.1.
• External HTTP(S) links open in the system browser; file, JavaScript, and data URLs are blocked.
• Electron runs with Node.js integration disabled, context isolation enabled, and sandboxing enabled.
• DSH configuration, sessions, and credentials remain in ~/.dsh (on Windows: %USERPROFILE%.dsh). Uninstalling the desktop launcher does not remove that directory.
• The launcher does not expose Electron IPC APIs to the DSH page.

Your configured model providers and DSH tools may make their own network requests. Review their respective settings and policies before use.

Troubleshooting

Development

Development requires Windows, Node.js 24.19.0, pnpm 11.20.0, and a built checkout of DeepSeek Harness.

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm install --frozen-lockfile
pnpm test
$env:DSH_RUNTIME_ROOT = 'D:\Repository\deepseek-harness'
pnpm run dist

Build output is written locally to *release* and is not committed. Pushing a vX.Y.Z tag builds Windows x64, macOS Apple Silicon/Intel, and Linux x64 AppImage/DEB packages.

Project documentation

Project status, active work, architecture constraints, and iteration records are available from the documentation entry point.

Support and contribution

• Report defects and feature requests through GitHub Issues.
• Before submitting a pull request, run the test suite and keep user-facing text in Simplified Chinese where applicable.
• See the upstream DeepSeek Harness repository for DSH-specific functionality and documentation.

License

This project is licensed under the Apache License 2.0.