Qubicl

어떤 AI 에이전트에게도 여러분의 머신에서 실제 개인 컴퓨터를 제공하세요.

영구적인 파일. 터미널 액세스. 웹 리서치. 지속되는 브라우저와 데스크톱. 원할 때마다 사람이 직접 제어할 수 있습니다. Qubicl 계정, 클라우드 제어 평면, 모델 종속이 없습니다.

빠른 시작 · 왜 Qubicl인가 · 컴퓨터 · 클라이언트 · 보안 · 문서

npm install -g qubicl-cli

Qubicl은 로컬 Docker를 외부 AI 에이전트용 관찰 가능한 컴퓨터로 전환합니다. 에이전트는 Codex, Claude, Open WebUI, Cursor, VS Code, 또는 다른 MCP/OpenAPI 클라이언트에 머무릅니다. Qubicl이 작업에 사용할 머신을 제공합니다.

your model or agent
        │
        │  MCP / OpenAPI / Open Terminal
        ▼
 localhost-only Qubicl gateway
        │
        ├── terminal + managed processes
        ├── durable, host-visible files
        ├── keyless web search + local extraction
        ├── persistent Chromium + desktop
        ├── packaged, operator-controlled skills
        └── live viewer + human takeover

왜 Qubicl인가

Related MCP server: EdgeBox

빠른 시작

요구 사항: Docker Engine 또는 Docker Desktop이 있는 Linux, Docker Desktop이 있는 macOS, 또는 WSL 2 및 Docker Desktop을 통한 Windows 11—그리고 Node.js 22 또는 24와 Docker Compose 2.24+. 네이티브 Windows 실행과 WSL 1은 지원되지 않습니다. WSL 설치에서는 Qubicl 상태와 컴퓨터 홈을 /home 아래의 WSL Linux 파일시스템에 유지해야 합니다.

qubicl setup

설정 마법사는 Docker를 확인하고, 컴퓨터 프리셋을 비교하며, 디스크 및 리소스 사용량을 미리 보고, 선택한 이미지를 가져온 다음, 첫 번째 컴퓨터를 생성할 수 있습니다. Qubicl은 일반 사용자로 실행하세요. 절대 sudo로 실행하지 마세요.

다른 컴퓨터를 만들고 에이전트를 연결하세요:

qubicl create computer-name --preset computer
qubicl connect computer-name --client codex

connect는 클라이언트 구성을 출력합니다. 클라이언트 파일을 편집하거나 bearer 토큰을 출력하지 않습니다. 로컬 stdio 클라이언트의 경우 구성에 토큰이 없습니다.

git clone https://github.com/EldanRing/qubicl.git
cd qubicl
npm ci
npm run images:build
npm install -g --prefix "$HOME/.local" ./packages/cli
export PATH="$HOME/.local/bin:$PATH"
qubicl setup

컴퓨터 선택

프리셋은 레이어를 공유하면서 서로 다른 기능 계약을 노출합니다. 선택한 컴퓨터가 지원할 수 없는 도구는 디스커버리에서 제외됩니다.

모든 프리셋에는 키가 필요 없는 네이티브 web_search, 로컬 web_extract, 그리고 영구적이고 에이전트가 편집할 수 있는 작업 복사본이 포함된 6가지 검증된 Qubicl 네이티브 스킬 베이스라인이 포함됩니다. 운영자는 각 컴퓨터가 노출할 도구와 스킬을 선택합니다:

qubicl tools computer-name
qubicl skills computer-name

비활성화된 도구는 MCP, OpenAPI, Open Terminal에서 사라지며, 캐시된 호출은 fail closed 방식으로 차단됩니다.

모든 에이전트 연결

qubicl connect computer-name --client codex
qubicl connect computer-name --client claude-code
qubicl connect computer-name --client cursor
qubicl connect computer-name --client opencode
qubicl connect computer-name --client openclaw
qubicl connect computer-name --client hermes-agent
qubicl connect computer-name --client open-webui

어댑터는 Codex, Claude Code, Claude Desktop, Cursor, VS Code, Open WebUI, 일반 stdio 및 HTTP MCP, 직접 OpenAPI를 지원합니다. 정적 프로필은 더 작은 파일, 시맨틱 브라우저, 비주얼 브라우저 또는 데스크톱 카탈로그를 노출할 수 있습니다.

Open WebUI에서는 생성된 구성을 관리자 패널 → 설정 → 통합 → Open Terminal에 복사하세요. Qubicl은 Open WebUI의 Docker 네트워크에 참여하지 않고 네이티브 영구 파일 탐색 및 검색, 파일시스템 기반 채팅 업로드, 스크린샷, 브라우저 도구, 명시적으로 게시된 로컬 미리보기를 제공합니다.

정확한 지침은 클라이언트 설정을 참조하세요.

지켜보고 제어하기

qubicl view computer-name

관찰은 수동적입니다. 제어권 넘겨받기는 에이전트 도구를 가두고, 키보드와 마우스를 넘겨주기 전에 에이전트의 일반 관리 명령을 종료합니다. 지속형 브라우저와 명시적으로 관리되는 데스크톱 애플리케이션은 계속 표시되므로 처음부터 다시 시작하는 대신 정확히 그 작업을 이어갈 수 있습니다.

에이전트가 작업하는 동안 뷰어는 Qubicl의 녹색 포인터를 최신 데스크톱 또는 관리형 브라우저 위치에 유지하고 정확한 클릭 대상을 잠시 깜빡입니다. 시맨틱 브라우저 클릭은 페이지 요소에서 Chromium과 실시간 noVNC 캔버스를 통해 매핑되므로, 뷰어 크기 조정과 레터박스가 발생해도 표시기가 정렬된 상태를 유지합니다. 표시기는 입력 디스패치 전에 나타나고, 뷰어 리로드 후에도 유지되며, 에이전트가 임대를 잃거나 사람이 제어권을 넘겨받으면 사라집니다. 표시기는 뷰어 전용으로 유지됩니다—사람의 입력, 웹페이지, 에이전트 스크린샷에는 영향을 주지 않습니다—그리고 뷰어 헤더에서 끌 수 있습니다.

제어 중인 뷰어가 사라지면 Qubicl은 짧은 재연결 유예 기간 후 버려진 제어를 해제합니다. 운영자는 언제든지 명시적으로 제어권을 회수할 수 있습니다:

qubicl control release computer-name

일상적인 사용을 위해 설계됨

• 인증된 루프백 미리보기를 통해 에이전트가 시작한 로컬 웹 앱을 게시합니다.

• 영구 홈을 백업, 검증, 암호화, 복원, 복제, 체크포인트합니다.

• offline, web-only, developer 또는 사용자 지정 이그레스 정책을 적용합니다.

• 비밀을 워크로드에 넣지 않고 범위가 좁은 자격 증명을 중개합니다.

• 제한된 devcontainer 정의를 가져오고 호스트 매개 Git 워크플로우를 사용합니다.

• 편집기와 일반 ssh/scp를 위해 루프백 전용 SSH를 활성화합니다.

• 비공개이며 내용이 포함되지 않은 감사 추적을 검사하고 doctor로 토폴로지를 진단합니다.

• ID, 토큰, 정책, 리소스, 홈을 보존하면서 컴퓨터를 제자리에서 업그레이드합니다.

전체 CLI를 살펴보려면 qubicl help 또는 qubicl <command> --help를 사용하세요.

보안 경계

Qubicl은 모든 컴퓨터를 하나의 명시적인 Docker 리소스 및 파일시스템 경계 안에 유지합니다. 컴퓨터는 권한 모드, Docker 소켓, 호스트 네임스페이스, 임의 마운트, 비밀번호 없는 권한 상승 없이 실행됩니다. 게이트웨이는 127.0.0.1에서만 수신합니다. Chromium은 Linux 네임스페이스와 렌더러 seccomp-BPF 샌드박스를 유지합니다. 모델에 노출되는 파일은 영구 홈에만 국한됩니다. 컨트롤러와 워크로드 프로세스는 동일한 컴퓨터 컨테이너를 공유하므로, 사람의 제어권 인수는 적대적 코드 경계라기보다 협력적인 관리 프로세스 울타리입니다.

Qubicl은 신뢰할 수 있거나 운영자가 감독하는 워크로드를 위한 Docker 기반 컴퓨터이며, 적대적인 사용자 정의 이미지, 커널 악용, Docker 침해, 또는 호스트 계정을 제어하는 다른 사용자로부터 보호하는 VM 경계가 아닙니다. 기본 developer 네트워크 프로필은 아웃바운드 액세스를 허용합니다. 이 경계에 의존하기 전에 전체 보안 모델을 읽으세요.

릴리스 상태

Qubicl 0.1.x는 최초 공개 시리즈입니다. 실제 사용에 적합하지만, 인터페이스와 상태 형식은 1.0 이전에 변경될 수 있습니다. Linux x64, Docker Desktop이 있는 Apple Silicon macOS, Docker Desktop이 있는 WSL 2의 Ubuntu 24.04를 통한 Windows 11 x64는 첫 릴리스에서 직접 테스트되었습니다. Linux ARM64, Intel macOS, Windows on ARM 및 기타 WSL 배포판은 최선의 노력(best-effort) 수준으로 지원됩니다. 네이티브 Windows와 WSL 1은 지원되지 않습니다. Qubicl 컴퓨터는 모든 호스트에서 Linux 컨테이너로 유지됩니다. 업그레이드 전에 중요한 컴퓨터 홈을 백업하세요.

문서

라이선스: 소스 코드와 문서는 Apache-2.0이며, 지정된 Qubicl 로고와 공식 브랜드 아트웍은 CC BY 4.0입니다. 허용되는 브랜드 사용 및 저작자 표시는 BRANDING.md를 참조하세요.

기여를 환영합니다—CONTRIBUTING.md에서 시작하고, SECURITY.md에 설명된 저장소의 비공개 보안 신고 양식을 통해 취약점을 신고하세요.