Pinned runtime
PINNED RUNTIMEThe app bundles verified Node.js, pnpm, and DeepSeek Harness. It ignores your global environment and never downloads dependencies on first run.
DeepSeek Harness Desktop · a community project
Everything you need,
already installed.
DeepSeek YukiRyou packages DeepSeek Harness into an installable desktop app with a pinned runtime inside — double-click and start working.
Account balance, workspace review, Git changes, file previews, a community plugin marketplace, and trusted updates, all in one native window.
$ shasum -a 256 DeepSeek.YukiRyou-1.0.9-arm64.dmg
An open-source community project, not an official DeepSeek product
Harness = Runtime + Desktop
A desktop shell that keeps Harness running on your machine
Harness is the body of an agent.
The desktop shell fits that body into your operating system: runtime, processes, windows, and updates.
Native shell
NATIVE SHELLThe Electron main process owns the native window, traffic lights, tray, and updates. Single instance, hide on close, and it reclaims every process it started.
Loopback boundary
LOOPBACK ONLYHarness listens only on a stable 127.0.0.1 loopback origin the app persists, never exposed to the LAN, and web content runs in a sandboxed view with Node integration off and context isolation on.
Design approach
Open and run. Every release verifiable.
Open and run
No Node to prepare, no launch command to remember, no ports to juggle. The app ships a pinned runtime and Harness as one atomic release unit — double-click the icon and the workbench is there. Harness and the local UI recover independently, so one failure never takes down the window.
Every change reviewable
File tree, Git changes vs HEAD, line stats, and read-only diff all live in the app: search, filter, ordered review, in-preview find, and drag files or lines straight into chat. Each turn’s confirmed changes appear below the outputs row — one click opens the file for review.
A verifiable release chain
Public macOS packages are Developer ID signed, Apple notarized, installed on clean machines, and stability-tested, with SHA-256 checksums attached. Before installing a plugin the app verifies catalog source, exact npm identity, dependency graph, SHA-512, and official tarballs — without lowering security requirements.
Features
Put Harness into an installable desktop app
Not a rewrite of Harness, and it never changes how Agents work — it delivers Harness to your desktop stably, securely, and recoverably.
Open and run
OPEN AND RUNShips with pinned Node.js, pnpm, and DeepSeek Harness. Ignores your global environment, and no first-run dependency downloads.
Native experience
NATIVE EXPERIENCENative traffic lights, a draggable title bar, and a sidebar that overlays in narrow windows and docks when wide. Light, dark, and system themes stay in sync.
Account balance
ACCOUNT BALANCESee the balance of the DeepSeek account behind your credentials, right above Settings.
Workspace review
WORKSPACE REVIEWFile tree, Git changes vs HEAD, line stats, and read-only diff — with search, filtering, ordered review, in-preview find, and drag files or lines into chat.
Readable previews
READABLE PREVIEWToggle Markdown between rendered and source views; preview plain text and common images right in the app.
Per-turn changes
PER-TURN CHANGESConfirmed changes for each turn appear below native Harness outputs — one click opens the file for review.
Quiet lifecycle
QUIET LIFECYCLESingle instance; hide instead of quit. Harness and the local UI recover independently, so one failure never takes down the window.
Trusted updates
TRUSTED UPDATESDeveloper ID signed, Apple notarized, SHA-256 verified, with in-app update checks. You confirm before restarting to install.
Community plugin marketplace
PLUGIN MARKETPLACEFull catalog indexing, search, categories, paging, and source management — with a security pre-check before install.
Managed plugin lifecycle
MANAGED LIFECYCLEInstall, update, reinstall, enable, disable, rollback, and safe removal. Failures auto-restore the previous version and block known-bad builds.
Windows 11 support
WINDOWS 11Platform runtime, ConPTY, and NSIS installer — the same release ships for both macOS and Windows.
Windows portable build
PORTABLE BUILDUnzip the portable ZIP and run directly — no install. Built from the same commit with the same pinned runtime.
Why YukiRyou
Desktop capabilities beyond the official Web UI
The official DeepSeek Harness ships a Web UI, but daily use still means preparing a runtime, typing launch commands, juggling ports, and handling crashes. YukiRyou folds all of that into one app.
Not a web shortcut
A standalone app with a pinned runtime and Harness: double-click to launch, and it cleans up its own processes on quit.
A complete review loop
Beyond chat: file tree, current Git changes, per-turn changes, line stats, and rendered Markdown in one place.
Verifiable releases
Public packages are Developer ID signed, Apple notarized, installed on clean machines, and stability-tested — with SHA-256 checksums.
Compared with the alternatives
| Official Web UI | Browser shortcut | DeepSeek YukiRyou | |
|---|---|---|---|
| Runtime setup | Needs Node, pnpm, CLI | Service must be started first | Bundled — open and run |
| Desktop capabilities | None | None | Balance, file tree, Git diff, previews |
| Process management | Manual start/cleanup | Manual | Single instance, self-healing, cleanup on quit |
| Updates | Manual | Manual | In-app check, signed and notarized |
| Reproducible offline | Depends on local env | Depends on local env | Pinned bundled runtime |
Download & install
Three steps to start
Grab the installer for your platform from GitHub Releases: drag the DMG into Applications on macOS, or run the installer (or portable build) on Windows.
- 01
Download the installer
macOS: download the DMG. Windows: download Setup.exe or the portable ZIP — all from the same Release
- 02
Install
macOS: drag DeepSeek YukiRyou into Applications. Windows: run the installer, or unzip the portable build and run directly
- 03
Launch and configure
Launch from Launchpad or the Start menu, then configure services in the Harness UI
Security & privacy
Clear boundaries, trustworthy out of the box
From network edges to rendering isolation and the release supply chain, every layer has an explicit security design.
Random loopback port
Harness listens only on a random 127.0.0.1 address — never exposed to the LAN and never open to the public internet.
Isolated web view
Web content runs in a sandboxed view with Node integration disabled and context isolation enabled; the bridge exposes only validated capabilities.
Privacy-friendly diagnostics
Exported diagnostics contain only a sanitized environment summary and bounded logs — no source code, sessions, or credentials.
Trusted supply chain
Candidates ship only after Developer ID signing, clean-machine installs, real-world stability testing, Apple notarization, and final verification.
Verifiable plugin sources
The community catalog is discovery only, not an endorsement; identity, dependency graph, SHA-512, and official tarballs are verified before install, without lowering security requirements.
FAQ
Frequently asked questions
Find more answers on GitHub Issues.
Is this an official DeepSeek client?
No. This is an independently developed open-source macOS/Windows project with no affiliation or endorsement from DeepSeek.
Which platforms are supported?
The macOS release targets Apple Silicon (macOS 14 or later) with Developer ID signing and Apple notarization; Windows 11 x64 ships Beta builds. Intel Macs and Linux are not supported yet.
Why does the Windows build show a SmartScreen warning?
Windows builds are unsigned Betas, so SmartScreen may warn on first run. Only download from GitHub Releases and verify against the included SHA256SUMS-Windows.txt.
Is the plugin marketplace safe?
The community catalog is discovery only — it is not an endorsement or a security review. Before install, the app verifies catalog source, npm identity, dependency graph, SHA-512, and official tarballs; plugins share your local user permissions with Harness, so only install code you trust.
Why is the installer so large?
For offline startup and reproducible versions, the app bundles verified Node.js, pnpm, and Harness runtimes instead of relying on your global environment.
What if the app fails to start?
Export a diagnostics package from the app menu, then open a GitHub Issue with your OS version, app version, and steps to reproduce. Review the attachment for anything you do not want public.
How do updates work?
The app checks public GitHub Releases in the background and offers updates in Settings → About. You confirm before restarting to install.
Get started with DeepSeek YukiRyou
Download the app and let DeepSeek Harness work like a native desktop app. If this project helps you, give it a star.