DeepSeek Bot

Build a long-running bot team in DeepSeek Harness, with a chief bot to coordinate group chats and delegate work.

Stars
★ 2.9k
Last updated
today
License
Apache-2.0
Primary language
JavaScript

At a glance

How it runs
Desktop appWeb appSelf-hosted service
Works with
Platform-specific
Cost
Free software; you pay for model usage
Setup effort
Medium · a few setup steps
You'll need
DeepSeek HarnessNode.js 22.19 or laterpnpmGit (for GitHub installation)Shell / CLINetwork accessLocal filesystemMCP Server
Typical use
Individuals who want one entry point for coordinating several long-lived bots can ask Chief to help set up bots and group chats.
Not a fit if
  • Teams needing bots to run outside DeepSeek Harness
  • Users unwilling to pay for their model usage
  • Container operators needing bot access beyond mounted files
Source review
69/100 · Some gaps

What does this agent do, and when should you use it?

DeepSeek Bot is a plugin for DeepSeek Harness (DSH) that lets you create bots and talk and work with them inside DSH. On first launch, it provides a main bot called Chief to manage other bots and group chats and guide setup. Each bot can use a model configured in DSH and has manageable memory. In group chats, an admin bot answers by default, and bots can hand work to one another with @ mentions. The plugin runs in DSH Desktop or DSH Web, and DSH Web with the plugin can also be deployed using Docker; data is stored in bot/ and sessions/ under the DSH home folder.

After installing and enabling ds-bot, configure at least one model in DeepSeek Harness, then talk to Chief to set up other bots and group chats. Choose a model and manage memory on each bot's details page, or tell the bot to update its memory. In group chats, the admin bot handles messages by default; you can @ a specific bot directly, or have one bot hand work to another with @. The assigned bot works independently and shows progress in the group, sidebar, and its own chat, then posts its result in the group. Settings → Capabilities manages shared MCP servers, skills, and packs; local MCP commands require your approval before running. Settings → Usage reports token use by time, bot, and model.

  1. Individuals who want one entry point for coordinating several long-lived bots can ask Chief to help set up bots and group chats.
  2. Teams that want writing and coding bots to handle tasks in parallel can delegate with @ in a group chat and follow progress.
  3. Users who want a chosen DSH model and manageable memory for each bot can configure both on the bot's details page.
  4. Users who want DSH Web and the bot plugin on a NAS or always-on Linux machine can use the repository's Docker build directory.
  5. Users tracking model consumption can view token usage by time, bot, and model on the Usage page.

How do you install or deploy this agent?

Install DeepSeek Harness first and configure at least one model; DS Bot uses models from DSH.

In DSH Desktop (Windows or macOS), open Plugins → Add plugin, enter ds-bot in Package name or address, then select Install and Enable now. If npm is unreachable, use the full path to ds-bot-0.1.7.tgz downloaded from Releases, or install from Git:

github:Fei2411/DeepSeek-Bot#v0.1.7&path:/ds-bot

DSH Web supports Windows, macOS, and Linux and requires 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

For Docker deployment, use the docker/ directory, which contains instructions for building an image with DSH Web and DS Bot.

How do you use this agent?

Open DS Bot in DSH and start with the preconfigured main bot, Chief, which guides setup of other bots and group chats. Choose a model and manage memory on each bot's details page; in a group chat, type @ to pick a bot or use + → Reference a chat to add another conversation as context. Bots can hand work to each other; open the group details to stop a task. Manage capabilities in Settings → Capabilities and review token usage in Settings → Usage. In a container deployment, bots can access the content mounted into the container.

What are this agent's strengths and limitations?

Pros
  • The preconfigured Chief bot manages other bots and group chats and guides initial setup.
  • Group chats support direct @ mentions and bot-to-bot delegation, with progress and results visible to the group.
  • Each bot has manageable memory and its own model selection, which can be changed at any time.
  • A shared capability library offers MCP servers, skills, and packs, with approval required before local MCP commands run.
  • Data is stored in bot/ and sessions/ under the DSH home folder, and uninstalling the plugin does not remove it.
Limitations
  • It depends on DeepSeek Harness and requires at least one model configured there.
  • Bots use the user's model quota, and group chats cost more.
  • DSH Web installation requires Node.js 22.19 or later and pnpm.
  • In Docker, bots have full access to mounted content, so operators must choose mounts carefully.
  • The project is labeled v0.1 preview; the README makes no stable-release commitment.

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
DeepSeek Bot This agent 69 · Some gaps Desktop appFree + model costs ★ 2.9k today JavaScript —
Harness Desktop 82 · Good Desktop appFree + model costs ★ 12 1mo ago JavaScript —
somora 69 · Some gaps CLIFree ★ 32 4d ago TypeScript ChatGPT · Codex · Claude Code
Dive AI Agent 52 · Major gaps Desktop appFree + model costs ★ 1.8k 2mo ago TypeScript ChatGPT · OpenAI API · Claude API

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Some gaps
69/ 100 5-point scale 3.5 / 5
Trust 18/29
Reliability 9/14
Adaptability 14/18
Convention 14/18
Effectiveness 9/13
Verifiability 5/8
Why each dimension lost points
Trust18 / 29 · 3.1/5

The README and role design distinguish the management scope of the user, Main Bots, group admins, and ordinary Bots. Users set sandbox presets, full permissions require another confirmation, and local MCP commands require approval. The Docker note says Bots can access mounted content, while the permissions plan records a DSH menu path that can bypass Bot presets, so least privilege and confirmation are not comprehensive. Data documentation covers local storage, group memory boundaries, and data retention after uninstall, but the supplied material shows no dedicated sensitive-data protection or encryption. The release workflow uses OIDC provenance; the test workflow explicitly disables npm audit during npm ci, and the evidence does not describe dependency vulnerability handling. Failed archives retain sessions for retry; acknowledgments and the independent-project disclaimer clearly identify inspirations and attribution. Publisher identity is unverified and treated as unknown, with no score adjustment.

Reliability9 / 14 · 3.2/5

The workflows specify checks across operating systems, Node and DSH versions, packaging, and Docker; supplied tests cover Agent sessions, permission restrictions, archive failures, and error returns. README, the permissions plan, and tests are broadly consistent, but this static evidence cannot establish that checks passed. The project depends on DSH, Node/pnpm or the npm registry, with some alternatives such as offline packages or a mirror; it remains subject to external dependency availability. Tests show specific errors for some operations and preserve state on failure. Not all failure paths have documented user messages, so the scores are not higher.

Adaptability14 / 18 · 3.9/5

The README describes individual Bots, a main Bot, group chats, memory, a capability library, and usage views. The permissions plan specifies roles, sandbox presets, and some explicit limitations. Group responses default to an admin and users can address Bots with @, giving reasonably clear triggers, though not every trigger condition or boundary is documented. Installation covers Windows, macOS, Linux, and Docker/NAS, with separate instructions for the desktop app, DSH plugin, and web environment.

Convention14 / 18 · 3.9/5

The README is organized around installation, setup, features, data, and development, and links plugin documentation, contribution guidance, the changelog, and Docker instructions. Installation steps and platform requirements are concrete. Product and directory names are generally clear, though DSH and DS Bot version numbers differ in some places and readers must follow the versions in each command. Screenshots and procedural examples are present, but there is no systematic FAQ. The permissions plan records a known DSH menu bypass; the README advises checking important actions, while other limitations are sparsely documented. The Apache-2.0 license is included, and version badges, release checks, and a changelog provide version context. CI and contribution guidance show a maintenance process, but a responsible maintainer or long-term support commitment is not explicit. Unknown publisher identity is not itself a deduction.

Effectiveness9 / 13 · 3.5/5

Bots, group handoffs, group memory, and the capability library support team workflows, and the README describes usage tracking. It states that group chats cost more, Bots use the user's model quota, and can read or write files or run commands when asked. It does not quantify costs, quality gains, or task boundaries, so these scores remain moderate.

Verifiability5 / 8 · 3.1/5

Core features and boundaries can be traced to the README, permissions plan, workflows, and specific tests; the tests provide complementary evidence for Agent creation, archive failures, permission masks, and error responses. Sources corroborate some claims, but the supplied material omits complete implementation sources and cannot establish CI results or runtime behavior. Documentation distinguishes stated behavior from some known limitations, but some capability and safety claims remain project assertions without independent validation, so full marks are not justified.

Risks and how to mitigate them
  • The permissions plan says DSH's + and / menus can bypass Bot sandbox presets; Bots in Docker can access mounted directories. Review session permissions and mounted content before use.
  • The README says Bots use the user's model quota and can read or write files or run commands when asked; group chats cost more. The evidence does not describe sensitive-data encryption or a complete dependency vulnerability response process.
Evidence confidence: Low Reviewed Oct 21, 2026 Reviewed revision ae63b45c0d0e
See the full review method →

FAQ

Do I need a separate model or API key for DS Bot?
The README says to configure at least one model in DeepSeek Harness first; DS Bot uses DSH models, and bots consume your model quota.
Which files can the bots access?
In a container deployment, bots can access content mounted into the container. The README describes the container as their sandbox, with no access to anything else.
Can bots divide work among themselves?
Yes. In a group chat, one bot can hand work to another with @; the assigned bot works independently and posts progress and results.
Will uninstalling the plugin delete bot data?
No. Data is kept in bot/ and sessions/ under ~/.dsh by default, and uninstalling the plugin does not remove it.
Do group chats increase usage costs?
The README says group chats clearly cost more, and bots use your own model quota.
View on GitHub ↗ Install ↓

Related agents