cua-cli 0.1.1__tar.gz

cua_cli-0.1.1/.gitignore

@@ -0,0 +1,214 @@
+**/image/setup.iso
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+# C extensions
+*.so
+node_modules/*
+*/node_modules
+**/node_modules
+# Distribution / packaging
+.Python
+build/
+!libs/lume/scripts/build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/*
+!libs/lumier/src/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+# Translations
+*.mo
+*.pot
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+# Flask stuff:
+instance/
+.webassets-cache
+# Scrapy stuff:
+.scrapy
+# Sphinx documentation
+docs/_build/
+# PyBuilder
+.pybuilder/
+target/
+# Jupyter Notebook
+.ipynb_checkpoints
+# IPython
+profile_default/
+ipython_config.py
+.pdm.toml
+.pdm-python
+.pdm-build/
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+# SageMath parsed files
+*.sage.py
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+# Git worktrees
+.worktrees/
+# Spyder project settings
+.spyderproject
+.spyproject
+# Rope project settings
+.ropeproject
+# mkdocs documentation
+/site
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+# Scripts
+server/scripts/
+# Pyre type checker
+.pyre/
+# pytype static type analyzer
+.pytype/
+# Cython debug symbols
+cython_debug/
+# Ruff stuff:
+.ruff_cache/
+# PyPI configuration file
+.pypirc
+# Conda
+.conda/
+# Local environment
+.env.local
+# macOS DS_Store
+.DS_Store
+weights/
+weights/icon_detect/
+weights/icon_detect/model.pt
+weights/icon_detect/model.pt.zip
+weights/icon_detect/model.pt.zip.part*
+libs/python/omniparser/weights/icon_detect/model.pt
+# Example test data and output
+examples/test_data/
+examples/output/
+/screenshots/
+/experiments/
+/logs/
+# Xcode
+#
+# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
+## User settings
+xcuserdata/
+## Obj-C/Swift specific
+*.hmap
+## App packaging
+*.ipa
+*.dSYM.zip
+*.dSYM
+## Playgrounds
+timeline.xctimeline
+playground.xcworkspace
+# Swift Package Manager
+#
+# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
+# Packages/
+# Package.pins
+# Package.resolved
+# *.xcodeproj
+#
+# Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata
+# hence it is not needed unless you have added a package configuration file to your project
+.swiftpm/
+.build/
+# CocoaPods
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# Pods/
+#
+# Add this line if you want to avoid checking in source code from the Xcode workspace
+# *.xcworkspace
+# Carthage
+#
+# Add this line if you want to avoid checking in source code from Carthage dependencies.
+# Carthage/Checkouts
+Carthage/Build/
+# fastlane
+#
+# It is recommended to not store the screenshots in the git repo.
+# Instead, use fastlane to re-generate the screenshots whenever they are needed.
+# For more information about the recommended setup visit:
+# https://docs.fastlane.tools/best-practices/source-control/#source-control
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots/**/*.png
+fastlane/test_output
+# Ignore folder
+ignore
+# .release
+.release/
+# Shared folder
+shared
+# Trajectories
+trajectories/
+# Installation ID Storage
+.storage/
+# Gradio settings
+.gradio_settings.json
+# Lumier Storage
+storage/
+# Trashes
+.Trashes
+.Trash-1000/
+post-provision
+# Local secrets for act
+.secrets
+
+# Link checker scripts (dev tools)
+scripts/check-repo-md-links.py
+docs/scripts/check-links.py
+docs/scripts/check-all-links.py
+docs/scripts/check-mdx-links.py

cua_cli-0.1.1/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: cua-cli
+Version: 0.1.1
+Summary: Unified CLI for CUA - Computer-Use Agents
+Project-URL: Homepage, https://github.com/trycua/cua
+Project-URL: Documentation, https://docs.trycua.com
+Project-URL: Repository, https://github.com/trycua/cua
+Project-URL: Issues, https://github.com/trycua/cua/issues
+Author-email: TryCua <hello@trycua.com>
+License-Expression: MIT
+Keywords: agents,cli,cloud,computer-use,sandbox
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <3.14,>=3.11
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: cua-computer>=0.4.0
+Requires-Dist: cua-core>=0.1.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: all
+Requires-Dist: fastmcp>=2.0; extra == 'all'
+Requires-Dist: litellm>=1.74.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=2.0; extra == 'mcp'
+Provides-Extra: skills
+Requires-Dist: litellm>=1.74.0; extra == 'skills'
+Description-Content-Type: text/markdown
+
+# CUA CLI
+
+Unified command-line interface for CUA (Computer-Use Agents).
+
+## Installation
+
+```bash
+pip install cua-cli
+```
+
+## Usage
+
+```bash
+# Authentication
+cua auth login              # Authenticate via browser
+cua auth login --api-key    # Authenticate with API key
+cua auth logout             # Clear credentials
+cua auth env                # Export API key to .env file
+
+# Sandbox Management
+cua sb list                 # List all sandboxes
+cua sb create --os linux --size medium --region north-america
+cua sb get <name>           # Get sandbox details
+cua sb start <name>         # Start a stopped sandbox
+cua sb stop <name>          # Stop a running sandbox
+cua sb restart <name>       # Restart a sandbox
+cua sb suspend <name>       # Suspend a sandbox
+cua sb delete <name>        # Delete a sandbox
+cua sb vnc <name>           # Open sandbox in browser
+
+# Image Management
+cua image list              # List cloud images
+cua image list --local      # List local images
+cua image push <name>       # Upload image to cloud
+cua image pull <name>       # Download image from cloud
+cua image delete <name>     # Delete cloud image
+
+# Skills Management
+cua skills list             # List recorded skills
+cua skills read <name>      # Read a skill's content
+cua skills record <name>    # Record a new skill
+cua skills replay <name>    # Replay a skill
+cua skills delete <name>    # Delete a skill
+cua skills clean            # Delete all skills
+
+# MCP Server (for AI assistants)
+cua serve-mcp               # Start MCP server with all permissions
+cua serve-mcp --permissions sandbox:all,computer:readonly
+```
+
+## Installation Options
+
+```bash
+# Basic installation
+pip install cua-cli
+
+# With MCP server support
+pip install cua-cli[mcp]
+
+# With skills recording (VLM captioning)
+pip install cua-cli[skills]
+
+# Full installation
+pip install cua-cli[all]
+```
+
+## MCP Integration
+
+To use CUA with Claude Code or other MCP-compatible AI assistants:
+
+```bash
+# Add CUA as an MCP server
+claude mcp add cua -- cua serve-mcp
+
+# With specific permissions
+claude mcp add cua -- cua serve-mcp --permissions sandbox:all,computer:readonly
+
+# With a default sandbox
+claude mcp add cua -- cua serve-mcp --sandbox my-sandbox
+```
+
+### Available Permissions
+
+- `all` - All permissions
+- `sandbox:all` - Full sandbox management
+- `sandbox:readonly` - List and get sandboxes only
+- `computer:all` - Full computer control
+- `computer:readonly` - Screenshots only
+- `skills:all` - Full skills management
+- `skills:readonly` - List and read skills only
+
+Individual permissions: `sandbox:list`, `sandbox:create`, `sandbox:delete`, `sandbox:start`, `sandbox:stop`, `sandbox:restart`, `sandbox:suspend`, `sandbox:get`, `sandbox:vnc`, `computer:screenshot`, `computer:click`, `computer:type`, `computer:key`, `computer:scroll`, `computer:drag`, `computer:hotkey`, `computer:clipboard`, `computer:file`, `computer:shell`, `computer:window`, `skills:list`, `skills:read`, `skills:record`, `skills:delete`
+
+## Environment Variables
+
+- `CUA_API_KEY`: API key for authentication
+- `CUA_API_BASE`: API base URL (default: https://api.cua.ai)
+- `CUA_WEBSITE_URL`: Website URL for OAuth (default: https://cua.ai)
+- `CUA_MCP_PERMISSIONS`: Default MCP permissions (comma-separated)
+- `CUA_SANDBOX`: Default sandbox name for computer commands

cua_cli-0.1.1/README.md

@@ -0,0 +1,100 @@
+# CUA CLI
+
+Unified command-line interface for CUA (Computer-Use Agents).
+
+## Installation
+
+```bash
+pip install cua-cli
+```
+
+## Usage
+
+```bash
+# Authentication
+cua auth login              # Authenticate via browser
+cua auth login --api-key    # Authenticate with API key
+cua auth logout             # Clear credentials
+cua auth env                # Export API key to .env file
+
+# Sandbox Management
+cua sb list                 # List all sandboxes
+cua sb create --os linux --size medium --region north-america
+cua sb get <name>           # Get sandbox details
+cua sb start <name>         # Start a stopped sandbox
+cua sb stop <name>          # Stop a running sandbox
+cua sb restart <name>       # Restart a sandbox
+cua sb suspend <name>       # Suspend a sandbox
+cua sb delete <name>        # Delete a sandbox
+cua sb vnc <name>           # Open sandbox in browser
+
+# Image Management
+cua image list              # List cloud images
+cua image list --local      # List local images
+cua image push <name>       # Upload image to cloud
+cua image pull <name>       # Download image from cloud
+cua image delete <name>     # Delete cloud image
+
+# Skills Management
+cua skills list             # List recorded skills
+cua skills read <name>      # Read a skill's content
+cua skills record <name>    # Record a new skill
+cua skills replay <name>    # Replay a skill
+cua skills delete <name>    # Delete a skill
+cua skills clean            # Delete all skills
+
+# MCP Server (for AI assistants)
+cua serve-mcp               # Start MCP server with all permissions
+cua serve-mcp --permissions sandbox:all,computer:readonly
+```
+
+## Installation Options
+
+```bash
+# Basic installation
+pip install cua-cli
+
+# With MCP server support
+pip install cua-cli[mcp]
+
+# With skills recording (VLM captioning)
+pip install cua-cli[skills]
+
+# Full installation
+pip install cua-cli[all]
+```
+
+## MCP Integration
+
+To use CUA with Claude Code or other MCP-compatible AI assistants:
+
+```bash
+# Add CUA as an MCP server
+claude mcp add cua -- cua serve-mcp
+
+# With specific permissions
+claude mcp add cua -- cua serve-mcp --permissions sandbox:all,computer:readonly
+
+# With a default sandbox
+claude mcp add cua -- cua serve-mcp --sandbox my-sandbox
+```
+
+### Available Permissions
+
+- `all` - All permissions
+- `sandbox:all` - Full sandbox management
+- `sandbox:readonly` - List and get sandboxes only
+- `computer:all` - Full computer control
+- `computer:readonly` - Screenshots only
+- `skills:all` - Full skills management
+- `skills:readonly` - List and read skills only
+
+Individual permissions: `sandbox:list`, `sandbox:create`, `sandbox:delete`, `sandbox:start`, `sandbox:stop`, `sandbox:restart`, `sandbox:suspend`, `sandbox:get`, `sandbox:vnc`, `computer:screenshot`, `computer:click`, `computer:type`, `computer:key`, `computer:scroll`, `computer:drag`, `computer:hotkey`, `computer:clipboard`, `computer:file`, `computer:shell`, `computer:window`, `skills:list`, `skills:read`, `skills:record`, `skills:delete`
+
+## Environment Variables
+
+- `CUA_API_KEY`: API key for authentication
+- `CUA_API_BASE`: API base URL (default: https://api.cua.ai)
+- `CUA_WEBSITE_URL`: Website URL for OAuth (default: https://cua.ai)
+- `CUA_MCP_PERMISSIONS`: Default MCP permissions (comma-separated)
+- `CUA_SANDBOX`: Default sandbox name for computer commands

cua_cli-0.1.1/cua_cli/__init__.py

@@ -0,0 +1,3 @@
+"""CUA CLI - Unified command-line interface for Computer-Use Agents."""
+
+__version__ = "0.1.1"

cua_cli-0.1.1/cua_cli/api/__init__.py

@@ -0,0 +1 @@
+"""API client module for CUA CLI."""

cua_cli-0.1.1/cua_cli/api/client.py

@@ -0,0 +1,142 @@
+"""HTTP API client for CUA cloud services."""
+
+import hashlib
+import os
+from pathlib import Path
+from typing import Any, Optional
+from urllib.parse import quote
+
+import aiohttp
+from cua_cli.auth.store import require_api_key
+
+DEFAULT_API_BASE = "https://api.cua.ai"
+
+
+def get_api_base() -> str:
+    """Get the API base URL."""
+    return os.environ.get("CUA_API_BASE", DEFAULT_API_BASE).rstrip("/")
+
+
+class CloudAPIClient:
+    """HTTP client for CUA cloud API."""
+
+    def __init__(self, api_key: Optional[str] = None, api_base: Optional[str] = None):
+        self.api_key = api_key or require_api_key()
+        self.api_base = api_base or get_api_base()
+
+    def _headers(self) -> dict[str, str]:
+        return {
+            "Authorization": f"Bearer {self.api_key}",
+            "Accept": "application/json",
+        }
+
+    async def _request(
+        self,
+        method: str,
+        path: str,
+        json: Optional[dict] = None,
+        timeout: int = 30,
+    ) -> tuple[int, Any]:
+        """Make an HTTP request to the API.
+
+        Returns:
+            Tuple of (status_code, response_data)
+        """
+        url = f"{self.api_base}{path}"
+        headers = self._headers()
+
+        if json is not None:
+            headers["Content-Type"] = "application/json"
+
+        async with aiohttp.ClientSession() as session:
+            timeout_obj = aiohttp.ClientTimeout(total=timeout)
+            async with session.request(
+                method, url, headers=headers, json=json, timeout=timeout_obj
+            ) as resp:
+                try:
+                    data = await resp.json(content_type=None)
+                except Exception:
+                    data = await resp.text()
+                return resp.status, data
+
+    # Image API methods
+
+    async def list_images(self) -> list[dict[str, Any]]:
+        """List all images in the workspace."""
+        status, data = await self._request("GET", "/v1/images")
+        if status == 200 and isinstance(data, list):
+            return data
+        return []
+
+    async def initiate_upload(
+        self,
+        name: str,
+        tag: str,
+        image_type: str,
+        size_bytes: int,
+        checksum_sha256: str,
+    ) -> tuple[int, dict[str, Any]]:
+        """Initiate a multi-part upload session.
+
+        Returns:
+            Tuple of (status_code, session_data)
+        """
+        path = f"/v1/images/{quote(name, safe='')}/upload"
+        body = {
+            "tag": tag,
+            "image_type": image_type,
+            "size_bytes": size_bytes,
+            "checksum_sha256": checksum_sha256,
+        }
+        return await self._request("POST", path, json=body)
+
+    async def get_upload_part_url(
+        self, name: str, upload_id: str, part_number: int
+    ) -> tuple[int, dict[str, Any]]:
+        """Get a signed URL for uploading a part."""
+        path = f"/v1/images/{quote(name, safe='')}/upload/{upload_id}/part/{part_number}"
+        return await self._request("GET", path)
+
+    async def complete_upload(
+        self, name: str, upload_id: str, parts: list[dict[str, Any]]
+    ) -> tuple[int, dict[str, Any]]:
+        """Complete a multi-part upload."""
+        path = f"/v1/images/{quote(name, safe='')}/upload/{upload_id}/complete"
+        return await self._request("POST", path, json={"parts": parts})
+
+    async def abort_upload(self, name: str, upload_id: str) -> tuple[int, Any]:
+        """Abort an upload session."""
+        path = f"/v1/images/{quote(name, safe='')}/upload/{upload_id}"
+        return await self._request("DELETE", path)
+
+    async def get_download_url(self, name: str, tag: str) -> tuple[int, dict[str, Any]]:
+        """Get a signed URL for downloading an image."""
+        path = f"/v1/images/{quote(name, safe='')}/download?tag={quote(tag, safe='')}"
+        return await self._request("GET", path)
+
+    async def delete_image(self, name: str, tag: str) -> tuple[int, Any]:
+        """Delete an image version."""
+        path = f"/v1/images/{quote(name, safe='')}?tag={quote(tag, safe='')}"
+        return await self._request("DELETE", path)
+
+
+def calculate_file_hash(file_path: Path) -> str:
+    """Calculate SHA256 hash of a file."""
+    sha256 = hashlib.sha256()
+    with open(file_path, "rb") as f:
+        for chunk in iter(lambda: f.read(8192), b""):
+            sha256.update(chunk)
+    return sha256.hexdigest()
+
+
+def format_bytes(size_bytes: int) -> str:
+    """Format bytes in human-readable format."""
+    if size_bytes == 0:
+        return "0 B"
+    units = ["B", "KB", "MB", "GB", "TB"]
+    k = 1024
+    i = 0
+    while size_bytes >= k and i < len(units) - 1:
+        size_bytes /= k
+        i += 1
+    return f"{size_bytes:.2f} {units[i]}"

cua_cli-0.1.1/cua_cli/auth/__init__.py

@@ -0,0 +1,5 @@
+"""Authentication module for CUA CLI."""
+
+from .store import CredentialStore, clear_credentials, get_api_key, save_api_key
+
+__all__ = ["CredentialStore", "get_api_key", "save_api_key", "clear_credentials"]