DeepSeek Bot
Build a long-running bot team in DeepSeek Harness, with a chief bot to coordinate group chats and delegate work.
- Source repo
- Fei2411/DeepSeek-Bot
- Stars
- ★ 2.9k
- Last updated
- today
- License
- Apache-2.0
- Primary language
- JavaScript
- FA score
- 69/100 · Some gaps
At a glance
- How it runs
- Works with
- Platform-specific
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- 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.
- Individuals who want one entry point for coordinating several long-lived bots can ask Chief to help set up bots and group chats.
- Teams that want writing and coding bots to handle tasks in parallel can delegate with @ in a group chat and follow progress.
- Users who want a chosen DSH model and manageable memory for each bot can configure both on the bot's details page.
- 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.
- 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-botDSH 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] webFor 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?
- 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.
- 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?
Why each dimension lost points
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.
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.
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.
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.
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.
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.
- 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.