Skip to content
Fei2411Public

About

A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.

Topics

Resources

Contributing

Stars

8.6k stars

Watchers

15 watching

Forks

Repository files navigation

DS Bot

DS Bot

English | 中文

version DSH license

DS Bot is an open-source project built on DeepSeek Harness (DSH), available as a standalone desktop app or as a DSH plugin. It turns DSH into bots that you create, talk to and work with.

Sponsors

ModelGo ModelGo is a reliable, high-performance, enterprise-grade AI API aggregation platform. Access leading AI models—including Claude, OpenAI, Gemini, and DeepSeek—with a single API key. Sign up now and get 40% off DeepSeek V4.1 Flash.
Exclusive perks for DS-Bot users: get $0.50 in credits when you sign up, earn another $2 after your first API call, and receive up to $10 in bonus credits when you top up! Try it now: ModelGo Official Website

Say one sentence to Chief, and it sets up the bots and the group chat

Install

Desktop app (Windows, macOS, Linux)

The desktop app brings its own DSH, so you don't need to install DSH first. Download the installer for your system from Releases, open it, and set up a model in Settings (it can also copy your existing bot team from DSH).

If your system warns about an unsigned app: on Windows select More info → Run anyway; on macOS open System Settings → Privacy & Security and select Open Anyway.

As a plugin in DSH

First install DSH and set up at least one model in it. DS Bot uses the models from DSH.

  • DSH Desktop: In the sidebar, select Plugins → Add plugin, enter ds-bot (in mainland China, set Registry to Mainland China mirror), then select Install and Enable now.
  • DSH Web (needs Node.js 22.19 or later, and pnpm):
npx @deepseek-ai/[email protected] plugin --profile web add ds-bot
npx @deepseek-ai/[email protected] web

Docker (NAS, Linux server)

See docker/README.md.

Setup

I strongly recommend that you set up your other bots and group chats by just talking to a bot.

Web search

DS Bot selects its auto search provider for the whole profile. If you disable web-search-auto, also select another registered search provider in that profile. See Web search and the recovery steps.

Features

Browser remote (preview)

Use the phone app's interface in a browser without installing it. On the computer, open Settings → Phone, enable phone access, show a pairing code, then choose Open in a browser or Copy browser link. You can also paste the pairing link into the web app. The browser pairs as another device over the existing end-to-end encrypted link; remove it from the computer's paired-device list to revoke access.

The Relay Server must serve the web build: run npm ci && npm run export:web in mobile/, then set DSBOT_LINK_WEB_DIR to the absolute mobile/dist directory when starting the Relay Server. Use HTTPS/WSS outside localhost. relay.dsbot.app needs this deployment before its browser links work. Browser storage is AES-GCM encrypted with a non-extractable key in IndexedDB, but the browser still runs the Server's page: only use a trusted Server. Sensitive operations require the phone app or computer, and there are no background notifications. See the design and security limits.

MCP access (preview)

Other agents on this computer (Claude Desktop, Cursor, Codex, your own scripts) can talk to your Bots through MCP. Open Settings → MCP access, turn it on, and create a token for each client; the token is shown once. A client reaches only the Bots and groups you tick for it (the Main Bot by default, never a private Bot). It can list Bots and groups, send messages, wait for replies, read chats and see what waits for you; approvals, questions, settings and secrets stay on the computer.

Point an HTTP MCP client at http://127.0.0.1:8797/mcp with the header Authorization: Bearer <token>. For clients that only start a command, use DSBOT_MCP_TOKEN=<token> npx -p ds-bot ds-bot-mcp. See the design.

Bot

You can do all your talking and work with one bot, in one window. You don't need to worry about the context behind it. The bot's details page shows its info, and there you can pick the model and thinking level you want it to use. You can switch models at any time, but I still recommend that you keep one model for a bot for a long time, and switch only when you really need to.

Bots also have memory. A bot remembers what you like and uses it in later work. You can manage its memory on the bot's details page, or just tell the bot.

Each bot can have its own working folder and permission preset — just tell the bot when you want to switch folders. Your foreground chat stays responsive while a bot works: slow shell commands move to background jobs automatically, and a bot can start background tasks on its own or move an in-flight turn to the background when you send a new message; you can inspect progress, answer approvals, send follow-ups, or stop tasks from the header island, read task transcripts and stop tasks in the Tasks tab, or track active tasks, answer approvals, and stop them on mobile, or type /side to ask a side question. Bots can also draw charts, tables and forms in their replies, or run scheduled tasks. In the sidebar, you can group bots and group chats into collapsible sections by work.

Bot details: model, memory, usage

Main bot

The main bot is your chief. It has very high rights: it manages the other bots and the group chats. The first time you open DS Bot, there is already a main bot called Chief. Talk to it, and it walks you through the setup.

In short: have a question? Ask the main bot.

Group chats

DS Bot has group chats. A group chat is a great way to get several bots to work together, but it clearly costs more. So DS Bot does this: every group chat has an admin. The admin answers your messages by default and calls in the other bots for you. You can also @ a bot directly, and it answers you directly. To give the bots another chat as context, use + → Reference a chat in the message box.

Any bot can hand work to other bots with @, and those bots do the work on their own and post the results back to the group. A group chat has its own memory and working folder, invisible to bots outside the group. For larger work, a group chat can run a Goal: the admin aligns with you on what "done" means, splits the work into stages across members, and checks each stage before moving on.

Group chat: the admin, Chief, hands the work to Writer and Coder

Private bot

If you have private work that you only want to discuss with one bot, turn on Private in its settings and give it a separate working folder. Other bots cannot read its folder, memory or chat history, and sending messages to other bots or writing files outside its folder requires your approval. Even if you delete it, its folder and records stay protected until you release them in Settings.

Note that a private bot cannot be a main bot or join group chats. This boundary only isolates it from other bots in your team, not as an OS sandbox: if you give it shell or network access, its commands can still read and write system files or reach the network, and its model provider still receives the conversation.

Local agents

Coding-agent CLIs you already use on your computer (Claude Code, Codex CLI, Cursor CLI, GitHub Copilot, Devin CLI, OpenCode, Gemini CLI, Antigravity, Kimi CLI, Kilo CLI, and others) can be connected as bots directly. Pick Local agent when creating a bot (or switch in the bot's settings), and it will use the CLI's own sign-in, plan and models while working like any other bot in private chats, group chats, handoffs and memory.

There are a few limits to keep in mind: a local agent uses the CLI's own tools and context, so shared capabilities and connectors in DS Bot are not passed to it, and switching how a bot runs starts a fresh conversation part; only CLIs or custom CLIs that reject MCP servers altogether run without team tools such as creating bots or handing off work. Also, Cursor CLI saves the last selected model as its own global default (~/.cursor), so if you pick a specific model for a Cursor bot in DS Bot, other Cursor bots on the default model and Cursor in your terminal will switch to it too — keep "CLI default" if you don't want to change your global default (sign in to Cursor first so the model list loads).

Browser

Each bot has its own isolated browser with separate sign-ins, and can import cookies from a file or from your local browsers. Turn on a browser plugin in Settings → Browser to let bots open and operate web pages on their own; posting, uploading, downloading and deleting need your approval, and sign-in, captchas or payments hand back to you with a card so you can take over and hand back at any time.

The browser feature is available in the desktop app and DSH Desktop only (not in DSH Web), and only the desktop app keeps browser sign-ins after you quit and supports cookie import. On Windows, new Chrome and Edge cookies encrypted with v20 cannot be read directly — export them to a file with a browser extension first.

Computer use

Turn on Settings → Computer use to let bots operate apps on your computer as far as you allow. You can set a level (view only, background, or foreground) and allowed apps for each bot, with a top bar showing when a bot is working so you can pause or take over at any time; apps like system settings and password managers are never given to a bot.

All bots share your desktop, so only one bot can use a given app or the foreground mouse at a time. On Windows, Chrome and Electron apps often ignore background input and need "foreground", and apps running as administrator cannot be controlled; macOS requires 14 or later with Accessibility and Screen Recording permissions; Linux supports X11, with limited Wayland support.

IM

In Settings → IM, you can link a bot or group chat to WeChat, Feishu, DingTalk, WeCom, QQ, Telegram, Discord or Slack. Once paired, you can talk to your bots, @ them in groups, and answer question and approval cards directly from your chat app without a public IP or open port on your computer.

Messages only flow while your computer is awake and DS Bot is running. WeChat only supports private chat with the QR-paired account, not group chats; WeChat and QQ only allow replies within a platform time window after you send a message, and sending another message resumes it. WeChat, QQ and DingTalk do not have card buttons, so reply with the option number instead; for security, secret cards cannot be filled in from chat apps.

Connectors and capabilities

In Settings → Connectors, you can sign in to GitHub, Gmail, QQ Mail, 163 and other mailboxes, and remote MCP servers, or import existing configs from Claude Desktop, Cursor and VS Code. Credentials stay in DS Bot's secrets so bots never see the raw values, and emails written by a bot wait for your confirmation by default. Your own MCP server can be added too: give its address and turn on Sign in for a browser sign-in, or keep a fixed header or key when the server publishes no OAuth metadata.

In Settings → Capabilities, you can manage shared MCP servers, skills and packs for the team and enable them per bot; local commands added by a bot need your approval before they run.

Web search

The auto web search keeps the asking conversation's own route and key (never borrowing another route's key) with a keyless fallback, and now also tries DeepSeek's official Search API on that route's own origin. To use the official Search and Fetch APIs for every model, open the Plugins page and go to Web search, then turn on Use the new Web Search API; that switch selects both. A DeepSeek account sign-in is only verified for Search and Fetch. These calls are billed to your own API key by usage.

DeepSeek services

A DeepSeek API key can add independent image and document reading, DeepSeek text-to-speech (with a choice of voice) and DeepSeek dictation to any model, in Settings → DeepSeek services. Each capability is off until you turn it on; setting the key never uploads files or switches speech by itself. The key is set in Settings → Models, and the page shows whether each service is ready and why not. Dictation uses the existing Voice Input provider picker; when that plugin is off, your current dictation keeps working. Document reading is read-only: read_document takes a workspace path or a file or image attached to the current chat, and keeps the whole recognized text even when the result is long. These calls are billed to your own API key by usage.

Office files

Bots can create, check and edit Word (.docx), PowerPoint (.pptx) and Excel (.xlsx) documents directly, and render pages to images to check layout. The desktop app includes the full runtime out of the box; DSH Web does not bundle this runtime, so it can only check and edit existing documents, while creating files from scratch and rendering pages require the desktop app or DSH Desktop.

Usage

In Settings → Usage, you can see token usage by time, by bot and by model.

Usage page

Data

All data stays on your own computer: in the folder you chose on first start in the desktop app (~/.ds-bot by default), or in bot/ and sessions/ in the DSH home folder (~/.dsh by default) for the plugin. Uninstalling the app or the plugin does not delete this data.

Development

The plugin source is in ds-bot/. For options and internals, see ds-bot/README.md. For development, tests and how the team works, see CONTRIBUTING.md. For changes between versions, see CHANGELOG.md.

Acknowledgments

  • DeepSeek Harness: DS Bot is built on the DSH plugin system. Every bot works in DSH sessions and uses the DSH tools and models.
  • esbuild: bundles the plugin's interface code.
  • Thanks to these projects for the ideas they published. DS Bot learned from their designs and does not contain their code:
    • AgentMemoryRepo: the Markdown format of Bot memory.
    • OpenAI Codex: checkpoints that keep the user's messages next to the summary, and message anchors for chat search.
    • OpenMausBot: group chat rounds and @mention relays.
    • Hermes Agent and Hermes Bot Mode: one session per member per group chat, and handoffs that carry the earlier user messages.
    • OpenCode, goose, pi and Gemini CLI: when to condense a long chat, and what a handoff note holds.
    • obelisk: chat search with a SQLite full-text index.
  • Everyone who tries DS Bot, asks questions and reports bugs.

License

Apache License 2.0. Provided "as is", without any warranty. Third-party code and its license are listed in NOTICE.

Disclaimer

DS Bot is an independent community project. It is not an official DeepSeek product, and it is not affiliated with, endorsed by or sponsored by DeepSeek. "DeepSeek", "DeepSeek Harness" and the other names are trademarks of their owners. They are used here only to say what this plugin works with.

Bots use your own model quota, and they read and write files and run commands when you ask them to. Check important actions yourself.

About

A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.

Topics

Resources

Contributing

Stars

8.6k stars

Watchers

15 watching

Forks

Releases

Packages

Contributors

Languages