Apache-2.0 desktop companion that embeds DeepSeek Harness (or attaches to a signed-in Harness client via a connector plugin) behind a 3D avatar, delegating tasks to local tools and to Codex / WorkBuddy — Windows 10/11 x64 and macOS 13+ only.
DSH integration
Compatible
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-14
License
Apache-2.0
01What can it help you accomplish?
Give one spoken or typed instruction and have it actually run on the computer
Harness routes the task to local search, reading and computer operations, and the avatar reports public progress and the result back on the desktop
People who want an agent entry point on the desktop instead of a chat window they have to babysit
Hand work to Codex or WorkBuddy and follow it without watching a terminal
Tasks assigned to already installed and signed-in Codex / WorkBuddy, with public progress and results tracked in the app and optional spoken reports
Developers who already run Codex or WorkBuddy and want a companion surface that reports back
Keep a character with memory and a 3D body on the desktop while the agent works
A transparent 3D avatar with expressions and lip sync that supports voice, text and mouse interaction, plus local roles whose persona and history live in `SOUL.md`, `MEMORY.md` and per-day conversation documents
Users who want the agent to have a persistent face and persona rather than a fresh chat each time
02How to install into DeepSeek Harness
Prerequisites
- Runtime: Windows 10/11 x64 or macOS 13+, with the build that matches your CPU architecture
- For a source install: Node.js 24+, npm and Git
- Codex and WorkBuddy are not bundled — they must be installed and signed in separately if you want agent delegation
Installation steps
- 01
Download the installer for Windows x64 or Mac Apple Silicon from aibanlv.ai (Mac Intel is not supported yet), then pick a character and a usage mode
- 02
Or build from source: `git clone https://github.com/AIBanlv/AIBanlv-Bot.git`, `cd AIBanlv-Bot`, `npm ci`, `npm run setup`, `npm start`
$ git clone https://github.com/AIBanlv/AIBanlv-Bot.git
- 03
On Windows you can instead double-click **Setup AIBanlv.cmd** to initialize and then launch from the **AIBanlv Source** desktop shortcut
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
A desktop companion app that ships Harness inside it and can also attach to an already signed-in Harness client through its own connector plugin, then drives computer tools and Codex / WorkBuddy on the user's behalf
Harness-routed computer operations
a goal typed, spoken, or sent from a bound phone→the task routed by the built-in Harness to local search, reading and computer tools
real tool execution on the local machine within the current capability and authorization scopeCodex / WorkBuddy task delegation
a task to hand to an already installed and signed-in Codex or WorkBuddy→tracked public progress and results, with optional spoken reporting
tasks are handed to third-party agents that then act on the machine3D avatar with voice and touch interaction
voice, typed text, or mouse interaction→a transparent desktop avatar with expressions and lip sync that renders locally
local rendering, window interaction and lip-sync / expression processing run on the machineLocal characters with persistent memory
a character name, prompt and an audio file you are licensed to use; an optional LAM ZIP→a local role whose persona and history are kept in `SOUL.md`, `MEMORY.md` and per-day conversation documents
writes `SOUL.md`, `MEMORY.md` and daily conversation documents for local rolesPhone remote control, reminders and read-only mail check
tasks sent from the bound mobile app; scheduled reminder times→remote task submission, screenshots or chosen files pushed to the bound phone, timed reminders and a read-only email check with optional spoken summaries
screenshots and files leave the computer for the bound phone; the email integration is read-only and does not send mail
04Who is it for? When not to use it?
Good for
- People who want an agent entry point on the desktop instead of a chat window they have to babysit
- Developers who already run Codex or WorkBuddy and want a companion surface that reports back
- Users who want the agent to have a persistent face and persona rather than a fresh chat each time
Not for
- The packaged app targets Windows 10/11 x64 and macOS 13+ only, and Mac Intel is explicitly not adapted yet. A source build on Apple Silicon additionally needs native macOS 15+ and resources that pass a self-check on the target machine.
- Local mode still needs network model services: a Qwen Realtime key for voice and voice cloning, and either a DeepSeek key or a connected Harness client for text and computer tasks. The README states plainly that "local" does not mean the models work offline.
- Online mode talks to AIBanlv services and model tasks send necessary content to the chosen model provider; screenshots, files and email content can contain private data, so the README asks you to read the settings notes before enabling them.
- Apache-2.0 covers the original desktop source only. The logo, trademarks, app icons, character likenesses and related audio/video or motion assets are not licensed with the source and need separate permission before redistribution or commercial sale.
05Compatibility, maintenance and safety notes
- The packaged app targets Windows 10/11 x64 and macOS 13+ only, and Mac Intel is explicitly not adapted yet. A source build on Apple Silicon additionally needs native macOS 15+ and resources that pass a self-check on the target machine.
- Local mode still needs network model services: a Qwen Realtime key for voice and voice cloning, and either a DeepSeek key or a connected Harness client for text and computer tasks. The README states plainly that "local" does not mean the models work offline.
- Online mode talks to AIBanlv services and model tasks send necessary content to the chosen model provider; screenshots, files and email content can contain private data, so the README asks you to read the settings notes before enabling them.
- Apache-2.0 covers the original desktop source only. The logo, trademarks, app icons, character likenesses and related audio/video or motion assets are not licensed with the source and need separate permission before redistribution or commercial sale.
Apache-2.0 · README evidence only, no tagged release, no security audit
06Frequently asked questions
How does AIBanlv Bot use DeepSeek Harness?
Harness is built into the app as the agent runtime that routes tasks to restricted computer tools; a connector plugin under `demos/web-desktop-pet/harness-client-plugin/` can also link it to an already signed-in Harness client. The app itself is a separate desktop program, so it is not installed into a DSH profile.
What do I need before installing it?
Windows 10/11 x64 or macOS 13+ with the build matching your CPU architecture, and for a source install Node.js 24+, npm and Git. Mac Intel is not adapted yet, and a full Apple Silicon source environment additionally needs native macOS 15+ with resources that pass a self-check on the target machine. Codex and WorkBuddy are not bundled.
Do local roles work without an internet connection?
No. The README states that "local" does not mean the models run offline: local mode still needs a Qwen Realtime key for voice and voice cloning, plus either a DeepSeek key or a connected Harness client for text and computer tasks, and the models and speech services still reach their providers.
Which parts of the repo can I redistribute?
The original desktop source is Apache-2.0, so you can use, modify, redistribute and sell it while keeping the license and notices and marking your changes. The AIBanlv logo, trademarks, app icons, character likenesses and related audio/video or motion assets are explicitly not licensed with the source and need separate permission.
07Related DSH workflows
open-design
by nexu-io
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create motion, prototypes, websites, apps, dashboards, presentations, images, and videos with your team and AI agents. Share work, exchange feedback, and iterate together in one workspace.
mole
by tw93
🐹 Open-source Mac and PC cleaner. Keep your machine clean, light, and running like new. Fast CLI, plus native Mac and Windows apps.
dsh-desktop
by anywhere-labs
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem. Everything is a plugin — even the desktop shell itself.
picgo
by molunerfinn
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosting services (S3, GitHub, Cloudflare R2, Imgur, Aliyun OSS...). Paste, upload, done.
08Data and sources
Harness 已内置，也可通过[连接插件](demos/web-desktop-pet/harness-client-plugin/README.md)关联已登录的 Harness 客户端；Codex、WorkBuddy 需另行安装并登录…
[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)：本项目内置任务路由与受限电脑工具的智能体运行基础。
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-14. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.