trycua/cua

AI エージェント向けのクロスプラットフォーム コンピューター操作フレームワーク、バックグラウンド駆動・サンドボックス・ベンチマーク機能を統合。

開発の材料自由に使える · MITAI エージェントHTML難易度
28,0860 保存
1,992フォーク510Issue
デモ・公式サイトをひらくcua.ai

中辛 の解説

Cua はコンピューター操作エージェント向けの統合プラットフォームです。Cua Drivers(macOS・Windows・Linux のバックグラウンド駆動)、Cua サンドボックス SDK(Python 3.11+ で VM やコンテナ制御)、Cua Bench(OSWorld・ScreenSpot などのベンチマーク環境)、Lume(Apple Silicon の macOS VM 管理)で構成されます。Claude Code・Cursor などから同じ CLI で複数 OS を操作でき、API は Linux コンテナから Android まで統一されています。セットアップは pip install または curl スクリプトで数分で完了し、デモやチュートリアルが充実しているため実装難度は中程度です。

こんなリポジトリです

こんなときに便利です

  • AI エージェントにデスクトップタスク自動化能力を付与し、Web フォーム入力やアプリ操作をコード不要で実装する
  • 複数 OS にまたがるエージェント動作を検証・評価し、OSWorld や ScreenSpot ベンチマークで性能を定量測定する
  • macOS ならではのハイパフォーマンス VM 環境を構築して、エージェント学習用データを大規模生成する

主な機能

バックグラウンドコンピューター操作ドライバ(macOS・Windows・Linux で統一 CLI)クロスプラットフォーム サンドボックス SDK(コンテナ・VM・クラウド・ローカル統一 API)組込みベンチマーク・RL 環境とモデル評価ツールセット

ほかとの違い

同じ Python API で Linux・macOS・Windows・Android を操作でき、ベンチマーク・学習環境が統合されている点、および macOS ではカーソル奪取なしのバックグラウンド駆動が可能な点が従来のVM管理ツールやローカルエージェント実装と異なります。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Python 3.11 以上(Cua SDK 利用時)
  • QEMU または Apple Virtualization.Framework(VM 実行時)
  • curl または PowerShell(インストール用)

すぐに始める

  1. Linux または macOS にドライバをインストール
/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"
  1. Windows に PowerShell でインストール(別の場合)
irm https://cua.ai/driver/install.ps1 | iex
  1. Python SDK をセットアップ
pip install cua
  1. Python スクリプトでサンドボックスを作成して操作
from cua import Sandbox, Image
async with Sandbox.ephemeral(Image.linux()) as sb:
    await sb.screenshot()
    await sb.mouse.click(100, 200)
    await sb.keyboard.type("Hello from Cua!")
  1. Cua Bench をセットアップしてベンチマークを実行
git clone https://github.com/trycua/cua && cd cua/cua-bench
uv tool install -e . && cb image create linux-docker
cb run dataset datasets/cua-bench-basic --agent cua-agent --max-parallel 4
  1. Lume で macOS VM を作成・実行
/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"
curl -L "$(lume ipsw | tail -n 1)" -o ~/Downloads/macos-tahoe.ipsw
lume create macos-tahoe --ipsw ~/Downloads/macos-tahoe.ipsw --unattended tahoe
lume run macos-tahoe

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try trycua/cua

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

28,0867日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

ベストサンプルサンプル評点 64/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2025 年に作成

「AI エージェント」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/trycua/cua.svg)](https://www.gitbap.com/r/trycua/cua)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る