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: taw-computer

クイックスタート

要件: 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の状態とコンピュータのホームをWSL Linuxファイルシステムの/homeの下に保持する必要があります。

qubicl setup

セットアップウィザードはDockerをチェックし、コンピュータのプリセットを比較し、ディスクとリソース使用量をプレビューし、選択したイメージを取得し、最初のコンピュータを作成できます。Qubiclは通常のユーザーとして実行し、sudoは使用しないでください。

別のコンピュータを作成し、エージェントを接続します:

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

connectはクライアント設定を出力します。クライアントファイルを編集したり、ベアラートークンを出力したりすることはありません。ローカルの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から消え、キャッシュされた呼び出しはフェイルクローズします。

任意のエージェントを接続

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の場合、生成された設定をAdmin Panel → Settings → Integrations → Open Terminalにコピーします。Qubiclは、Open WebUIのDockerネットワークに参加せずに、ネイティブの永続ファイルブラウジングと検索、ファイルシステムバックアップのチャットアップロード、スクリーンショット、ブラウザツール、明示的に公開されたローカルプレビューを提供します。

正確な手順はClient setupを参照してください。

監視と引き継ぎ

qubicl view computer-name

観察は受動的です。Take controlはエージェントのツールをフェンスし、通常の管理コマンドを終了してから、キーボードとマウスをあなたに渡します。永続的なブラウザと明示的に管理されたデスクトップアプリケーションは表示されたままなので、最初からやり直すのではなく、正確なタスクを続行できます。

エージェントが動作している間、ビューアはQubiclの緑色のポインターを最新のデスクトップまたは管理ブラウザの位置に保ち、正確なクリックターゲットを短くパルス表示します。セマンティックブラウザのクリックは、ページ要素からChromiumとライブのnoVNCキャンバスを通じてマッピングされるため、ビューアのリサイズやレターボックスでもインジケーターは整列したままです。これは入力ディスパッチの前に表示され、ビューアのリロード後も維持され、エージェントがリースを失うか人間が制御を引き継ぐとクリアされます。これはビューアのみに表示され、人間の入力、ウェブページ、エージェントのスクリーンショットには影響しません。ビューアのヘッダーからオフに切り替えることができます。

制御中のビューアが消えた場合、Qubiclは短い再接続猶予期間の後に放棄された制御を解放します。オペレーターはいつでも明示的に回復できます:

qubicl control release computer-name

日常利用のために

• 認証付きループバックプレビューを通じて、エージェントが起動したローカルWebアプリを公開します。

• 永続的なホームをバックアップ、検証、暗号化、復元、クローン、チェックポイントします。

• offline、web-only、developer、またはカスタムのエグレスポリシーを適用します。

• シークレットをワークロードに置かずに、狭い範囲の認証情報を仲介します。

• 制限付きdevcontainer定義をインポートし、ホスト仲介のGitワークフローを使用します。

• エディタと通常のssh/scpのためにループバック専用SSHを有効にします。

• プライベートでコンテンツフリーの監査証跡を検査し、doctorでトポロジーを診断します。

• ID、トークン、ポリシー、リソース、ホームを保持したまま、コンピュータをその場でアップグレードします。

完全なCLIを調べるには、qubicl helpまたはqubicl <command> --helpを使用してください。

セキュリティ境界

Qubiclは、すべてのコンピュータを1つの明示的なDockerリソースおよびファイルシステム境界内に保ちます。コンピュータは、特権モード、Dockerソケット、ホスト名前空間、任意のマウント、パスワードなしの昇格なしで実行されます。ゲートウェイは127.0.0.1のみでリッスンします。ChromiumはLinux名前空間とレンダラーのseccomp-BPFサンドボックスを保持します。モデル向けファイルは永続的なホームに限定されます。コントローラーとワークロードのプロセスはコンピュータコンテナを共有するため、人間による引き継ぎは、敵対的なコード境界ではなく、協調的な管理プロセスフェンスです。

Qubiclは、信頼された、またはオペレーターが監督するワークロード向けのDockerベースのコンピュータであり、敵対的なカスタムイメージ、カーネルエクスプロイト、Dockerの侵害、またはホストアカウントを制御する別のユーザーに対するVM境界ではありません。デフォルトのdeveloperネットワークプロファイルはアウトバウンドアクセスを許可します。境界に依存する前に、完全なsecurity modelを読んでください。

リリース状況

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ディストリビューションはベストエフォートです。ネイティブWindowsとWSL 1はサポートされていません。QubiclコンピュータはすべてのホストでLinuxコンテナのままです。アップグレード前に重要なコンピュータのホームをバックアップしてください。

ドキュメント

ライセンス: ソースコードとドキュメントはApache-2.0です。指定されたQubiclロゴと公式ブランドアートワークはCC BY 4.0です。許可されたブランド使用と帰属については、BRANDING.mdを参照してください。

貢献は歓迎します。CONTRIBUTING.mdから始めてください。脆弱性は、SECURITY.mdに記載されているリポジトリのプライベートセキュリティ報告フォームを通じて報告してください。