Telemetry in CUA

CUA tracks anonymized usage and error report statistics; we ascribe to Posthog's approach as detailed here. If you would like to opt out of sending anonymized info, you can set telemetry_enabled to false.

What telemetry data we collect

CUA libraries collect usage data to help improve our software. We have two categories of telemetry:

Opt-Out Telemetry (Enabled by Default)

Basic performance metrics and system information that help us understand usage patterns:

• System Information: Operating system, OS version, Python version
• Module Initialization: When modules are imported and their versions
• Performance Metrics: Agent run durations, step counts, token usage, and API costs
• Session Tracking: Anonymous session IDs and run IDs for performance analysis

Opt-In Telemetry (Disabled by Default)

Conversation Trajectory Logging: Full conversation history including:

• User messages and agent responses
• Computer actions and their outputs
• Reasoning traces from the agent

Important: Trajectory logging is opt-in only and must be explicitly enabled.

We do NOT collect:

• Personal information or user identifiers
• API keys or credentials
• File contents or application data
• Information about files being accessed
• Actual screenshots or screen contents (unless trajectory logging is enabled)
• Specific text being typed, including user inputs, model outputs, computer outputs, or tool call outputs (unless trajectory logging is enabled)

Controlling Telemetry

We are committed to transparency and user control over telemetry. There are two ways to control telemetry:

1. Environment Variable (Global Control)

Telemetry is enabled by default. To disable telemetry, set the CUA_TELEMETRY_ENABLED environment variable to a falsy value (0, false, no, or off):

# Disable telemetry before running your script
export CUA_TELEMETRY_ENABLED=false

# Or as part of the command
CUA_TELEMETRY_ENABLED=1 python your_script.py

Or from Python:

import os
os.environ["CUA_TELEMETRY_ENABLED"] = "false"

2. Instance-Level Control

Computer SDK

from computer import Computer

# Enable telemetry (default)
computer = Computer(telemetry_enabled=True)

# Disable telemetry
computer = Computer(telemetry_enabled=False)

Agent SDK

from agent import ComputerAgent
import os

# Basic telemetry - performance metrics only (opt-out, enabled by default)
agent = ComputerAgent(
    model="claude-3-5-sonnet-20241022",
    telemetry_enabled=True  # Default is True
)

# Enable telemetry with full conversation trajectory logging (opt-in)
agent = ComputerAgent(
    model="claude-3-5-sonnet-20241022",
    telemetry_enabled={
        "log_trajectory": True  # Logs full conversation items
    }
)

# Disable telemetry completely
agent = ComputerAgent(
    model="claude-3-5-sonnet-20241022",
    telemetry_enabled=False
)

# Disable telemetry completely using environment variables
os.environ["CUA_TELEMETRY_ENABLED"] = "false"
agent = ComputerAgent(
    model="claude-3-5-sonnet-20241022"
)

You can check if telemetry is enabled for an instance:

print(computer.telemetry_enabled)  # Will print True or False
print(agent.telemetry_enabled)     # Will print True, False, or dict

Note that telemetry settings must be configured during initialization and cannot be changed after the object is created.

Detailed Telemetry Events

Computer SDK Events

Agent SDK Events

Transparency

We believe in being transparent about the data we collect. If you have any questions about our telemetry practices, please open an issue on our GitHub repository.