mininglamp-oss/octo-admin

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.