DeepSeek Harness Pure Portable
Official tagged DeepSeek Harness source, built without code patches, in one clean Windows desktop app.
Download the latest ZIP · Get the optional Custom API plugin · 中文说明
| Trust point | What it means |
|---|---|
| Upstream stays upstream | The selected official dsh-v* tag is built without source edits through its own release:verify, build:official, and release:pack process. |
| Only the Windows experience is added | The project supplies pinned Node.js, pnpm, and Electron components, an independent window, a portable data directory, and an explicit update prompt. |
| No hidden capability layer | The default ZIP does not bundle or automatically install any capability plugin. Optional plugins have separate packages, checksums, and Releases. |
[!IMPORTANT] This is an independent community packaging project. It is not affiliated with, endorsed by, sponsored by, or an official release channel of DeepSeek. “DeepSeek Harness” and the whale logo identify the packaged upstream software and remain DeepSeek trademarks and brand assets.
Get started in three steps
- Download
DeepSeek-Harness-win64-v<version>.zipfrom Releases, including preview versions when available. - Extract the ZIP to a short path such as
C:\Tools\DeepSeek-Harness. - Double-click
DeepSeek-Harness.exe, accept the preview notice, add a DeepSeek API key when prompted, choose a workspace, and start a session.
No Node.js, installer, or administrator access is required. No API key is bundled. Windows SmartScreen may show an unrecognized-app warning because the community-built desktop shell is not code-signed; verify the Release checksum before choosing More info → Run anyway.
What the portable app adds
| What it gives you | |
|---|---|
| Zero setup | The Node.js runtime, production dependencies, and a hash-pinned pnpm used only by optional official plugin commands are included. No WebView2, registry changes, or administrator access is required. |
| A dedicated desktop window | The Electron shell opens upstream DeepSeek Harness in its own window and stops the local server when the window closes. |
| Portable data | Settings, sessions, manually installed plugins, and logs stay under dsh-home beside the app. Move or back up the folder as one unit. |
| Verifiable releases | Node.js downloads are checked against official SHA256 files; the manifest records exact component and upstream source identities; each Release includes checksums. |
| Clean-machine testing | Every push builds and boots on fresh Windows Server 2022 and 2025 GitHub runners before artifacts are published. |
| Automatic upstream tracking | Every six hours, the release workflow checks the highest official dsh-v* tag, builds that exact commit with the upstream release process, and publishes the next verified portable version when needed. It does not wait for an npm publication. |
| Update awareness | The app checks published portable Releases at most once a day and asks before opening the verified download page. It never replaces files silently. |
Portable ZIP or the official npm install?
| Pure Portable ZIP | Official npm package | |
|---|---|---|
| Best for | Trying the app, non-technical users, removable drives | Developers and managed Node.js environments |
| Setup | Extract and double-click | Install a supported Node.js version and the npm package |
| Updates | The app reports published updates; download the new ZIP and keep dsh-home |
Update through npm |
| Runtime | Bundled and pinned | Uses the machine's Node.js installation |
| Plugins | None installed by default | None added by this project |
Optional: DSH Custom API Capabilities
DSH Custom API Capabilities is a separate, opt-in Bundle for OpenAI-compatible custom models. It detects supported reasoning levels and image input, preserves every explicit model setting, and does not make active inference requests to public endpoints by default.
Download the independently versioned package and checksum from the DSH Custom API Capabilities v0.1.2 Release. Installing or updating a portable ZIP never installs this plugin for you.
Compatibility and verification
- System: Windows 10 21H2 or newer, Windows 11, x64 architecture.
- Permissions: no administrator access; the UI and its server stay on the local machine.
- Upstream input: either a published
@deepseek-ai/dshpackage for local builds or the complete package set produced from an exact official Git tag by upstream release scripts. - Package contents: the verified DeepSeek Harness production tree, official Node.js runtime, hash-pinned pnpm for explicit plugin management, Electron desktop shell, portable directories, notices, and launchers; no capability plugin is bundled.
- Build-path privacy: packaging changes no executable upstream code or runtime configuration. It makes generated, non-executable source-region and package-manager shim comments repository-relative, then scans every packaged file for the actual repository, runner, temporary, package-input, and user-home paths before creating the ZIP.
- Verification: compare the downloaded ZIP with
SHA256SUMS.txt, then runverify-package.ps1for a real boot and UI-render probe. - Current maturity: DeepSeek Harness 0.1 is a preview for Harness developers; its UI, plugin APIs, and package layout can change quickly.
See Building and verification for the source provenance checks, build inputs, Windows matrix, and release process.
Build it yourself
# Windows 10+, PowerShell 7.2+, and access to the npm registry
.\build-portable.ps1
Without an official package directory, the command builds from a published npm version and produces dist\DeepSeek-Harness-win64-v<portable-version>.zip plus dist\SHA256SUMS.txt. manifest.json records the portable version separately from the packaged dsh version and exact source provenance when supplied.
FAQ
Where is my data?The dsh-home folder beside the executable contains settings, sessions, manually installed plugins, and logs. Copy that folder to back up or migrate your data. Workspaces stay wherever you selected them.
Close the app and delete its folder. The portable build creates no installer or registry entry. To remove Electron's browser cache as well, delete %APPDATA%\DeepSeek Harness Pure Portable if it exists.
Yes. Run dsh.cmd web for the Web UI or dsh.cmd --profile headless "task" for a headless task. The shim starts the packaged official CLI directly. Install a downloaded Bundle explicitly with dsh.cmd plugin --profile <profile> add <plugin.tgz> --offline.
The app checks this repository's complete published portable Releases at most once every 24 hours. A newer version produces an opt-in prompt with the current and new portable versions. It does not download or replace files; verify the checksum, close the app, extract the new package, and preserve dsh-home and workspace. Set DSH_UPDATE_CHECK=0 before launch to disable the check.
The first run initializes the profile and Windows antivirus software may scan the full portable package. The startup page shows observed milestones, elapsed time, and the exact number of prepared profile components when the package manifest provides that total. The bar advances only when work is observed as complete, so it may pause during security scanning instead of displaying a misleading estimate. Later launches are usually faster.
Contributing and support
Found a packaging bug or compatibility problem? Open an issue with your Windows version, package filename, reproduction steps, and sanitized logs. See CONTRIBUTING.md before sending a pull request and SECURITY.md for private vulnerability reporting.
Problems in DeepSeek Harness itself belong in the upstream issue tracker.
License and attribution
The packaging tools in this repository are available under the MIT License. Built ZIPs are assembled from DeepSeek Harness (MIT, © DeepSeek AI), Node.js, Electron, and npm dependencies under their respective licenses. Exact versions and source provenance are recorded in each package's manifest.json. The whale mark is reproduced from the upstream favicon only to identify the packaged upstream software; its inclusion does not imply DeepSeek endorsement or authorization. See Third-party notices for its source and license notice.
No comments yet. Be the first to write one.