Open and run
Ships with pinned Node.js, pnpm, and DeepSeek Harness. Ignores your global environment, and no first-run dependency downloads.
Apple Silicon BetaLatest release 0.2.1-beta.1Make DeepSeek Harness
Make DeepSeek Harness
feel like a real Mac app
A standalone desktop workbench for Apple Silicon: bundled runtime, account balance, workspace review, file preview, and trusted updates. Open and run.
An open-source community project, not an official DeepSeek product
- macOS 14+
- Apple Silicon (M1+)
- MIT License
DeepSeek YukiRyou · Harness workbench in a native macOS window
Features
Put Harness into an installable Mac app
Not a rewrite of Harness, and it never changes how Agents work — it delivers Harness to your desktop stably, securely, and recoverably.
Native experience
Native traffic lights and a draggable title bar. Light, dark, and system themes stay in sync with Harness visuals.
Account balance
See the balance of the DeepSeek account behind your credentials, right above Settings.
Workspace review
A collapsible companion panel with the file tree, Git changes vs HEAD, added/removed line stats, and read-only diff.
Readable previews
Toggle Markdown between rendered and source views; preview plain text and common images right in the app.
Per-turn changes
Confirmed changes for each turn appear below native Harness outputs — one click opens the file for review.
Quiet lifecycle
Single instance; hide instead of quit. Harness and the local UI recover independently, so one failure never takes down the window.
Trusted updates
Developer ID signed, Apple notarized, SHA-256 verified, with in-app update checks. You confirm before restarting to install.
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 |
How it works
Stable, isolated, recoverable
Harness runs on a pinned runtime bundled inside the app, visible only to your machine.
- 1
DeepSeek YukiRyou.app
Double-click to launch; the app starts its bundled runtime
- 2
Electron main process
Owns the native window, updates, and recovery
- 3
Bundled Node.js
Never touches your global installs
- 4
Pinned Harness version
Shipped as one atomic unit with the desktop shell
- 5
Random 127.0.0.1 port
Loopback only — never exposed to the LAN
- 6
Isolated WebContentsView
Node integration off, context isolation and sandbox on
- Harness only listens on a random loopback address and is never exposed to the LAN.
- Web content runs in a sandboxed view with Node integration disabled and context isolation enabled.
- The desktop bridge exposes only a small set of validated capabilities.
Download & install
Three steps to start
Grab the Apple Silicon DMG from GitHub Releases and drag it into Applications.
- 1
Download the DMG
Download DeepSeek.YukiRyou-<version>-arm64.dmg from GitHub Releases
- 2
Drag into Applications
Open the DMG and drag DeepSeek YukiRyou into your Applications folder
- 3
Launch and configure
Launch from Launchpad, then configure services in the Harness UI
Roadmap
What’s next
The roadmap signals direction, not release dates; features stay unavailable until the security model or upstream interfaces are ready.
DeepSeek Pet
A stable companion character with idle blinking, sleep/wake states, and a “gobbling tokens” runtime animation — confined to its activity area.
Mobile remote control
With explicit pairing and permission boundaries: check task status on your phone, get essential alerts, and confirm before the agent continues.
Plugin marketplace
Plugin discovery, details, install, update, removal, and permission disclosure — after design, signature, and compatibility validation.
Direction, not promises: features are never shipped early via unstable DOM injection or by lowering security requirements.
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.
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 project with no affiliation or endorsement from DeepSeek.
Does it support Intel Macs or Windows?
Only Apple Silicon arm64 builds are shipped today. Intel, Windows, and Linux are out of scope for now.
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 macOS 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 real Mac app. If this project helps you, give it a star.