Skip to content

Repository files navigation

CubePlex

Cloud-native platform for managed agents in team workspaces

CI Docs Website Python 3.12+ Node 20+ Docker | Kubernetes

CubePlex is a cloud-native platform for managed agents in team workspaces — skills, shared memory, MCP tools, persistent sandboxes, governed access, and self-hosted deploy on Docker Compose or Kubernetes.

CubePlex architecture: clients, the application and agent runtime, workspace sandboxes, external services, and persistent infrastructure

The diagram reflects the current application architecture. CubePlex's agent runtime is built on CubePi, an async-native agent framework for multi-provider model access, tool execution, streaming, middleware, and durable checkpoints. Workspace sandboxes are isolated execution environments with persistent working state; external model providers, MCP servers, and IM platforms remain outside CubePlex's trust boundary.

Features

Area What you get
Multi-model chat Hosted and custom providers (Anthropic, OpenAI, and more). Attach files, stream replies, switch models mid-conversation.
Skills Packaged agent capabilities — built-in, org-uploaded, or from remote registries (e.g. skills.sh).
Memory Personal, workspace, and org-scoped memory the agent recalls across conversations.
MCP tools Catalog of connectors with static credentials or OAuth; grant tools per workspace.
Workspace sandboxes Per-workspace isolated runtimes with persistent storage — files, packages, and the working tree survive restarts so agents resume the same work site.
Artifacts Versioned deliverables — files, previews, code, images — rendered in the thread.
Automation Scheduled tasks (cron / interval / one-shot) and webhook event triggers.
IM bridges Talk to agents from Slack, Discord, Teams, Feishu, DingTalk, and more.
Team governance Organizations, workspaces, roles, model access policies, and cost tracking.
Deploy anywhere Docker Compose for a single host; Helm for Kubernetes.

Get started

Both modes use the same backend and frontend images. Guides cover image builds, configuration, secrets, and verification.

Develop locally

Prerequisites: Python 3.12+, Node.js 20+, pnpm 10+, and Docker (recommended for local services).

git clone https://github.com/cubeplexai/cubeplex.git
cd cubeplex
make install

# Terminal 1 — API
cd backend && python main.py

# Terminal 2 — web UI
cd frontend && pnpm dev

Backend: http://localhost:8000 · Frontend: http://localhost:3000.

Local setup also needs backend env/config files described in the contribution guide.

Repository layout

backend/    FastAPI API and Cubepi-based agent runtime
frontend/   Next.js web app and shared TypeScript packages
deploy/     Docker Compose and Kubernetes/Helm assets
docs/       Product docs site and engineering reference
scripts/    Worktree provisioning and dev helpers

Documentation and contributing

Releases

Packages

Used by

Contributors

Languages