whatisgithub

What is octo-admin?

mininglamp-oss/octo-admin — explained in plain English

Analysis updated 2026-05-18

15TypeScriptAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

In one sentence

The admin dashboard for the OCTO platform, letting operators manage tenants, users, channels, and AI Lobster agents through a thin React interface backed entirely by octo-server.

Mindmap

mindmap
  root((octo-admin))
    What it does
      Tenant management
      User and org admin
      Channel moderation
      Agent config
    Tech stack
      React
      TypeScript
      Vite
      Ant Design
    Use cases
      Operate an OCTO deployment
      Manage Lobster agent settings
      Run internal admin panel
    Audience
      Platform operators
      DevOps teams
    Architecture
      Talks only to octo-server
      No own database
      SSO gated deployment

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

Give platform operators a single dashboard to manage OCTO tenants, orgs, and users

USE CASE 2

Moderate communication channels and audit activity across an OCTO deployment

USE CASE 3

Configure and toggle feature flags for Lobster AI agents without touching the backend directly

USE CASE 4

Deploy an internal, SSO-protected admin surface separate from the public-facing OCTO web client

What is it built with?

TypeScriptReactViteAnt Designpnpm

How does it compare?

mininglamp-oss/octo-adminaredotna/api-examplesceelog/openweread
Stars151515
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audienceops devopsdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a running octo-server backend instance to connect to before the admin panel is useful.

Free to use, modify, and distribute, including commercially, as long as you keep the license and attribution notices.

So what is it?

OCTO Admin is the operator console for a larger platform called OCTO, which is described as a workplace where humans work alongside AI agents called Lobsters. This particular repository is not the main platform itself, but the web-based admin panel that the people running an OCTO deployment use day to day: managing tenants, organizations, users, communication channels, and the configuration of those Lobster agents, all from one interface. Built with React, TypeScript, and Vite, with the Ant Design component library for its interface, octo-admin is intentionally thin. It holds no business logic and no database of its own. Every screen you see and every action you take turns into a call to the admin API of a separate backend service called octo-server, which actually enforces permissions and stores the data. This design choice means the admin panel cannot do anything the backend does not already allow, so there is no gap between what the interface shows and what the system actually permits. The project is meant to be deployed separately from the main user-facing product. Since it is an operator tool, the intended setup is to publish it on an internal address, protected by something like a VPN or single sign-on, while the regular OCTO web client stays on the public internet. Getting started involves cloning the repository, installing dependencies with pnpm, and pointing it at a running octo-server instance through an environment file. Inside the codebase, pages are organized by feature, such as tenants, organizations, users, channels, and agents, alongside a shared component library and a typed API client. The project supports both English and Simplified Chinese interfaces. It is one of nine repositories that make up the broader OCTO ecosystem, and is released under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
Show me how to clone octo-admin and point it at a local octo-server instance
Prompt 2
Explain how octo-admin's pages map to octo-server's admin API endpoints
Prompt 3
Help me set up SSO-gated internal hosting for octo-admin in production
Prompt 4
Walk me through the tenant and user management screens in octo-admin
Prompt 5
How does octo-admin fit into the rest of the OCTO ecosystem of repositories

Frequently asked questions

What is octo-admin?

The admin dashboard for the OCTO platform, letting operators manage tenants, users, channels, and AI Lobster agents through a thin React interface backed entirely by octo-server.

What language is octo-admin written in?

Mainly TypeScript. The stack also includes TypeScript, React, Vite.

What license does octo-admin use?

Free to use, modify, and distribute, including commercially, as long as you keep the license and attribution notices.

How hard is octo-admin to set up?

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

Who is octo-admin for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.