For a first installation, use the standalone DS Bot desktop app: it includes DeepSeek Harness (DSH). Choose the installer for your operating system, open the app, configure a model, and send Chief a short test message. If you already use DSH, add the ds-bot plugin instead.
DeepSeek Bot, also called DS Bot, is a community-built, open-source project for creating persistent AI teammates. It is separate from the official DeepSeek chat website. The program runs locally, while a configured model provider processes your requests. The instructions below reflect the project documentation checked on November 11, 2026; screens may change as the project develops.
Which installation should you choose?
| Route | Best for | What you need |
|---|---|---|
| Standalone desktop app | New users who want a desktop interface | A supported computer and a model connection; DSH is included |
| DSH Desktop plugin | People already using DSH Desktop | DSH installed and at least one model configured |
| DSH Web plugin | Users comfortable starting a local web service | Node.js 22.19 or later, pnpm, and a model connection |
How do you install the standalone app?
- Find the Fei2411/DS-Bot project on GitHub and open its Releases page. Check that the publisher and repository match before downloading. Version 0.3.2 was the latest release listed when this guide was checked.
- Choose the release asset for your computer: Windows x64 installer, macOS Apple silicon or Intel archive, or Linux x86-64 AppImage/deb. The project also publishes SHA-256 checksums for checking downloads.
- Open the installer or extracted app and choose where to keep its data. If you have an existing DSH team, the app can offer to copy it; keep your original data until you have checked the copy.
- Open Settings → Models or follow Chief's setup card. Configure a provider and a model using that provider's own instructions. A model connection is needed before Chief can reply.
- Send:
Reply with “Setup complete” and tell me which model you are using.Confirm a response appears and check the Bot's selected model in its details panel. The reply alone is not proof of the underlying model identity.
Windows or macOS may warn that the app is unsigned. Check the download origin and checksum and decide whether you trust the software before using the operating system's option to open it. A warning is not a verification of safety.
How do you add DS Bot to DSH Desktop?
- Install DSH Desktop and configure at least one usable model in DSH.
- In the sidebar, open Plugins → Add plugin. Enter
ds-botas the package name. The project recommends the mainland China registry mirror for users there. - Choose Install, then Enable now. If DSH says a restart is required, quit it completely and reopen it.
- Open DS Bot, select a model if Chief asks, and send the same short test message. Check that the installed plugin and the DSH version are compatible if it does not load.
Can you run DS Bot in a browser?
Yes. The documented DSH Web route starts a local DSH web service. With Node.js and pnpm installed, the project's documented example is:
npx @deepseek-ai/dsh@0.2.2-rc.1 plugin --profile web add ds-bot
npx @deepseek-ai/dsh@0.2.2-rc.1 webThe DSH version in this example is pinned; the plugin is not. Record the installed versions. The built-in Bot browser panel described in other DS Bot tutorials is available in the desktop app and DSH Desktop, not DSH Web.
What should you check before using it for real work?
- Connection: Chief completes a short reply with the model you selected.
- Data location: note the location selected by the standalone app, or the DSH home directory for the plugin.
- Permissions: read file, shell and browser permissions before approving them. Start in a folder containing only material you intend to share.
- Cost: DS Bot uses the configured model service; its own usage screen counts tokens, not a final bill. Check your provider's terms before running a team.
If installation worked but Chief cannot answer, check the model, provider and credential first. Reinstalling the app will not fix an exhausted provider balance or a mismatched endpoint.
Learn what this project does in our DeepSeek Bot overview, then review the model connection before giving it a larger task.