cubeplexai/cubeplex

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 – 관리형 AI 에이전트를 위한 클라우드 네이티브 플랫폼

무엇인가요 – CubePlex는 팀이 격리된 워크스페이스 내에서 AI "에이전트"(채팅 스타일 어시스턴트)를 생성, 실행, 관리할 수 있는 오픈소스 클라우드 네이티브 애플리케이션입니다. CubeLoop 비동기 에이전트 프레임워크 기반의 FastAPI 백엔드와 Next.js 웹 UI를 통합하며, Docker Compose 또는 Helm/Kubernetes로 배포할 수 있습니다.

핵심 아이디어

관리형 에이전트 – OpenAI, Anthropic 등 어떤 LLM 제공자든 호출 가능하고, 도구를 실행하며 체크포인트를 유지할 수 있습니다.
팀 워크스페이스 – 각 워크스페이스는 고유한 사전 환경과 지속 저장소를 갖추어 에이전트가 중단된 지점에서 이어갈 수 있습니다.
스킬 및 메모리 – 재사용 가능한 기능 패키지("스킬")과 개인, 워크스페이스, 조직 스코프의 메모리가 대화 간에 유지됩니다.
MCP 도구 및 IM 브리지 – OAuth 또는 정적 자격 증명을 통한 외부 서비스 연결과 Slack, Discord, Teams 등 채팅 플랫폼 연동을 통해 팀이 이미 사용하는 도구에서 에이전트를 호출할 수 있습니다.
거버넌스 – 조직, 역할, 모델 접근 정책, 비용 추적 기능이 내장되어 있습니다.

주요 기능 (README에 기재된 내용)

영역	제공 기능
다중 모델 채팅	호스팅/사용자 정의 LLM 제공자 간 전환, 파일 첨부, 응답 스트리밍, 대화 중 모델 변경
스킬	패키지화된 에이전트 기능 – 내장, 조직 업로드, 또는 원격 레지스트리에서 가져오기
메모리	에이전트가 세션 간에 기억하는 개인, 워크스페이스, 조직 스코프 메모리
MCP 도구	정적 자격 증명 또는 OAuth를 갖춘 커넥터 카탈로그, 워크스페이스별 권한 부여 가능
워크스페이스 사전 환경	지속 저장소(파일, 패키지, 작업 트리)를 갖춘 격리된 런타임
아티팩트	버전 관리된 결과물(파일, 미리보기, 코드, 이미지)이 채팅 스레드에 렌더링됨
자동화	Cron/간격/일회성 작업 및 웹훅 트리거
IM 브리지	Slack, Discord, Teams, Feishu, DingTalk 등
팀 거버넌스	조직, 워크스페이스, 역할, 모델 접근 정책, 비용 추적
어디서든 배포 가능	Docker Compose(단일 호스트) 또는 Helm을 통한 Kubernetes

아키텍처 개요

클라이언트 – 웹 UI(Next.js)와 IM 봇은 HTTP/WebSocket을 통해 연결됩니다.
애플리케이션 계층 – FastAPI 서버는 CubeLoop 기반의 에이전트 런타임을 호스팅하며, 모델 호출, 도구 실행, 스트리밍, 내구성 있는 체크포인트를 처리합니다.
워크스페이스 사전 환경 – 각 워크스페이스별 컨테이너/포드와 지속 볼륨으로, 재시작 후에도 파일과 상태를 유지합니다.
외부 서비스 – LLM 제공자, MCP(모델 커넥터 플랫폼) 서버, 메시징 플랫폼은 신뢰 경계 외부에 있으며, CubePlex는 구성된 커넥터를 통해만 통신합니다.

시작하기

사전 요구 사항 – Python 3.12+, Node 20+, pnpm 10+, Docker(로컬 서비스용 옵션).

복제 및 설치:

git clone https://github.com/cubeplexai/cubeplex.git
cd cubeplex
make install   # 백엔드 가상환경과 프론트엔드 종속성 설정

로컬에서 실행:
- 터미널 1: cd backend && python main.py (FastAPI는 http://localhost:8000)
- 터미널 2: cd frontend && pnpm dev (Next.js는 http://localhost:3000)
제공된 Docker Compose 파일로 단일 호스트에, 또는 Helm 차트로 Kubernetes 클러스터에 본격적으로 배포 (README에 링크 있음).

리포지토리에서 보여주는 일반적인 사용 사례

단일 프롬프트로 전체 제품 웹사이트 생성.
"스킬"을 설치하고 사용하여 에이전트 기반 프론트엔드 구축.
원시 테이블 데이터를 포맷된 스프레드시트로 변환.
단일 페이지 PDF를 탐색 가능한 웹 페이지로 변환.
자율 브라우저 제어를 통해 웹 작업 완료.

더 알아보기

문서 사이트: https://docs.cubeplex.ai
핵심 개념: docs/site/docs/getting-started/core-concepts.md
배포 가이드: deploy/README.md
기여 가이드: CONTRIBUTING.md

결론 – CubePlex는 지속 상태, 도구 통합, 세밀한 거버넌스를 갖춘 AI 에이전트를 팀이 운영하고자 할 때, 컨테이너 또는 Kubernetes를 통해 온프레미스로 배포 가능한 프로덕션 수준의 스택을 제공합니다.

cubeplexai/cubeplex

CubePlex – 관리형 AI 에이전트를 위한 클라우드 네이티브 플랫폼

관련