Repolode
Submit
rlaope

rlaope/deepseek-bot

An always-on memory and messaging gateway for the DeepSeek Harness agent, reachable from Slack, Discord, Telegram and the terminal.

View on GitHub
Stars
215
Forks
23
Open issues
2
Last commit
4 days ago

What is it?

DeepSeek Harness runs an agent one session at a time. deepseek-bot is a plugin that keeps conversations durable across restarts, injects a persona, the agent's own notes and a recall index of past conversations into each turn, and lets the agent answer with dates or admit when it does not know.

It also exposes the agent through a gateway: Slack (Socket Mode), a fullscreen terminal called dsh, and Telegram and Discord adapters. Commands run in a Seatbelt sandbox on macOS, destructive actions wait for approval in the conversation, and the services run as launchd jobs that reconnect and restart automatically.

The Slack and terminal paths are used live by the developer; Discord and Telegram are tested against mocked APIs. The project is macOS-only and depends on DeepSeek Harness internals, so it is pinned to a specific harness version.

Key features

  • 01Keeps conversations as durable sessions that survive restarts.
  • 02Recalls past conversations within the same channel, scoped to avoid leaking private context.
  • 03Connects to Slack, Telegram and Discord, plus a fullscreen terminal (dsh).
  • 04Runs shell commands in a Seatbelt sandbox and asks for approval before destructive actions.
  • 05Supports MCP servers, document generation (docx, xlsx, pptx) and link reading.

Use cases

  • Running a personal AI assistant in Slack that remembers decisions from earlier threads.
  • Chatting with a DeepSeek-based agent from the terminal or a messaging app on a Mac.
  • Adding custom tools to an agent through MCP servers while keeping command execution sandboxed.

Quick start

  1. 1

    Install deepseek-bot with the official install script from the README (it pipes a script into bash, so run it yourself)

  2. 2

    Start talking to the bot in the terminal

    dsh
  3. 3

    Connect Slack, Telegram or Discord through the interactive setup

    dsh gateway setup

Things to know

  • macOS only; on Windows the installer, services, sandbox and watches are not supported.
  • Requires the DeepSeek Harness app and a DeepSeek API key, plus Node.js 22+.
  • Discord and Telegram have not been tested against a live server or bot.
  • DeepSeek Harness is a release candidate and the project depends on its internals, so pin your version.

In collections

Open-source personal AI agents

Topics

#personal-agent#deepseek#llm#slack-bot#discord-bot#telegram-bot#agent-memory#typescript#agent#cordis

FAQ

What is deepseek-bot?
An always-on memory and messaging gateway for the DeepSeek Harness agent, reachable from Slack, Discord, Telegram and the terminal. DeepSeek Harness runs an agent one session at a time. deepseek-bot is a plugin that keeps conversations durable across restarts, injects a persona, the agent's own notes and a recall index of past conversations into each turn, and lets the agent answer with dates or admit when it does not know.
Is deepseek-bot free to use? What license does it have?
deepseek-bot is open source under the MIT license. Check the license terms before using it in commercial products.
Is deepseek-bot still maintained?
Actively maintained. The last commit to deepseek-bot was on Nov 4, 2026.
What can I use deepseek-bot for?
Running a personal AI assistant in Slack that remembers decisions from earlier threads. Chatting with a DeepSeek-based agent from the terminal or a messaging app on a Mac. Adding custom tools to an agent through MCP servers while keeping command execution sandboxed.
How do I install deepseek-bot?
Install deepseek-bot with the official install script from the README (it pipes a script into bash, so run it yourself) Start talking to the bot in the terminal: dsh Connect Slack, Telegram or Discord through the interactive setup: dsh gateway setup
Where can I get deepseek-bot?
The source code and installation instructions are on GitHub: https://github.com/rlaope/deepseek-bot

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects