Skip to content

Repository files navigation

CubePlex

Cloud-native AI agent workspace for teams

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

CubePlex is a cloud-native AI agent workspace for teams. Chat across models, install skills, keep shared memory, connect MCP tools, automate runs, and govern team access — self-hosted on Docker Compose or Kubernetes.

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