whatisgithub

What is octop?

tencentcloud/octop — explained in plain English

Analysis updated 2026-05-18

265PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A self-hosted, multi-user AI assistant with switchable specialist agents, IM channel integrations, and built-in privacy and security controls.

Mindmap

mindmap
  root((repo))
    What it does
      Self-hosted AI assistant
      Multi-agent personas
    Tech stack
      Python
      FastAPI
      React
    Channels
      Web dashboard
      Feishu Discord DingTalk
    Use cases
      Household assistant
      Team coding delegate
    Audience
      Developers
      Teams and families

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a private, self-hosted AI assistant for a household or small team

USE CASE 2

Chat with different specialist agent personas depending on the task

USE CASE 3

Connect the assistant to messaging apps like Feishu, DingTalk, or Discord

USE CASE 4

Delegate coding tasks to tools like Claude Code or Codex through the Agent Client Protocol

What is it built with?

PythonFastAPIReactTypeScriptSQLite

How does it compare?

tencentcloud/octopcslawyer1985/claude-for-legal-zhhero8152/infinite-canvas
Stars265264266
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedevelopergeneralvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

One-line installer provisions Python automatically, extra setup is needed for IM channels and optional browser automation.

MIT license: free to use, modify, and reuse commercially as long as you keep the copyright notice.

So what is it?

Octop is a self-hosted AI assistant that runs on your own computer instead of a company's servers, built for households and small teams rather than a single person. Instead of one general chatbot, it gives each user their own set of specialized agents they can switch between depending on the task, and everything, including conversations, files, and login credentials, stays on your machine in a single folder. You can talk to Octop through a web dashboard, a command line interface, or through messaging apps like Feishu, DingTalk, QQ, Discord, and WeCom, and it also exposes a plain HTTP and streaming API for developers who want to build on top of it. One nice touch is a library of sixteen personality templates based on the well known MBTI framework, so different agents can be given distinct characters depending on what you want them to help with, such as a work assistant versus a household planner. Security features are built in rather than added on: multiple users are kept separate, tool use requires approval, shell commands are restricted, and personal information can be automatically redacted. Storage is flexible too, supporting local disk, Docker containers, or cloud object storage, and an agent's memory can travel along with its workspace using a built-in memory system with full text search. For developers, Octop also plugs into the Agent Client Protocol, letting other coding tools use an Octop agent, or letting Octop delegate coding tasks out to tools like Claude Code, Codex, or OpenCode. It is built in Python with FastAPI on the backend and React with TypeScript on the frontend. Getting started is meant to be simple: a one-line installer script sets up an isolated Python environment automatically on macOS, Linux, or Windows, without needing Python pre-installed. The project is released under the MIT license, a permissive license that allows free use, modification, and commercial reuse as long as the copyright notice is kept.

Copy-paste prompts

Prompt 1
Install Octop on my machine using the one-line installer script
Prompt 2
Set up an MBTI persona agent for household task planning in Octop
Prompt 3
Connect Octop to my Discord or Feishu account as a chat channel
Prompt 4
Configure Octop to delegate coding tasks to Claude Code via ACP
Prompt 5
Explain how Octop keeps user data and credentials local and isolated

Frequently asked questions

What is octop?

A self-hosted, multi-user AI assistant with switchable specialist agents, IM channel integrations, and built-in privacy and security controls.

What language is octop written in?

Mainly Python. The stack also includes Python, FastAPI, React.

What license does octop use?

MIT license: free to use, modify, and reuse commercially as long as you keep the copyright notice.

How hard is octop to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is octop for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.