Repolode
Submit
TencentCloud

TencentCloud/Octop

A self-hosted AI assistant for households and small teams, with multiple experts, IM channel integrations, and a web dashboard, all in one process.

View on GitHubWebsite
Stars
11,754
Forks
1,614
Open issues
787
Last commit
9 hours ago

What is it?

Octop is a self-hosted AI assistant platform for households and small teams. A single process serves a web dashboard, a CLI, IM channels such as Feishu, DingTalk, QQ, WeChat, Telegram, Discord and WeCom, and cron-based automation. Conversations, workspaces and credentials are stored under ~/.octop/, using SQLite by default or PostgreSQL as an option.

Each user can create several experts, each with its own workspace, model providers, channels and scheduled jobs. Experts can be built from 16 MBTI persona templates or a custom system prompt, and an AgentTeams feature (in beta) lets a coordinator schedule multiple experts on multi-step tasks. Users can also extend the assistant through connectors using OAuth and MCP, a knowledge base for document retrieval, and third-party plugins.

Octop also works as an ACP server for IDEs and terminals, and can delegate coding work to external agents such as Claude Code and OpenCode. It includes a browser automation tool built on headless Chromium, a remote desktop view, and a terminal assistant. Installation is available via a one-line script, pip, Docker, or native desktop builds.

Key features

  • 01Multiple experts per user, each with its own workspace, providers, channels and cron jobs
  • 02Chat via web dashboard, Feishu, DingTalk, QQ, WeChat, Telegram, Discord or WeCom
  • 03OAuth and MCP connectors, plus a knowledge base for document retrieval
  • 04ACP integration for IDEs and delegation to Claude Code or OpenCode
  • 05Browser automation, terminal assistant and remote desktop from the dashboard
  • 06Multi-user JWT authentication with tool approval and shell command guardrails

Use cases

  • A household sharing one self-hosted assistant, with a separate expert for each member
  • A small team routing tasks from Feishu, DingTalk or WeCom group chats to agents
  • A developer delegating coding tasks to Claude Code or OpenCode from the IDE or terminal
  • Scheduled daily jobs that the agent runs or pushes on a timetable

Quick start

  1. 1

    Run the official one-line installer for macOS/Linux (or the PowerShell installer on Windows)

  2. 2

    Open a new terminal so the octop command is on your PATH

  3. 3

    Run the first-run setup wizard

    octop init
  4. 4

    Start Octop (web dashboard, CLI, IM channels and cron in one process)

    octop run

Things to know

  • Self-hosting means you run and maintain the process, database and model keys yourself.
  • AgentTeams is in Beta and the mobile client is in closed beta.
  • The recommended installer is a remote script piped into a shell, so you must trust its source.

In collections

Open-source AI agent frameworks & appsMCP serversSelf-hosted appsAI chatbots & chat clientsOpen-source personal AI agents

Topics

#ai-agent#self-hosted#multi-agent#llm#chatbot#mcp#personal-assistant#agent#agentic-ai#ai

FAQ

What is Octop?
A self-hosted AI assistant for households and small teams, with multiple experts, IM channel integrations, and a web dashboard, all in one process. Octop is a self-hosted AI assistant platform for households and small teams. A single process serves a web dashboard, a CLI, IM channels such as Feishu, DingTalk, QQ, WeChat, Telegram, Discord and WeCom, and cron-based automation. Conversations, workspaces and credentials are stored under ~/.octop/, using SQLite by default or PostgreSQL as an option.
Is Octop free to use? What license does it have?
Octop is open source under the MIT license. Check the license terms before using it in commercial products.
Is Octop still maintained?
Actively maintained. The last commit to Octop was on Nov 7, 2026.
What can I use Octop for?
A household sharing one self-hosted assistant, with a separate expert for each member A small team routing tasks from Feishu, DingTalk or WeCom group chats to agents A developer delegating coding tasks to Claude Code or OpenCode from the IDE or terminal Scheduled daily jobs that the agent runs or pushes on a timetable
How do I install Octop?
Run the official one-line installer for macOS/Linux (or the PowerShell installer on Windows) Open a new terminal so the octop command is on your PATH Run the first-run setup wizard: octop init Start Octop (web dashboard, CLI, IM channels and cron in one process): octop run
Where can I get Octop?
The source code and installation instructions are on GitHub: https://github.com/TencentCloud/Octop

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

Related projects