Installation

This guide will help you install the cua-sdk SDK and set up your environment from scratch.

1. Prerequisites

• Python 3.8 or higher
• Git (optional, for cloning the repository)
• Docker (for agent containerization, optional but recommended)
• pip (Python package manager)

2. Create a Virtual Environment

python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

3. Install the SDK

You can install the SDK from PyPI (if published):

pip install cua-sdk

Or, install from source:

git clone https://github.com/eliastsoukatos/computer_use.git
cd computer_use
pip install .

4. Set Up Environment Variables

Create a .env file in your project directory to store API keys and configuration parameters.
Example:

OPENAI_API_KEY=your-openai-key
OTHER_CONFIG=your-value

The SDK uses python-dotenv to automatically load these variables.

5. Verify Installation

Test your installation with:

python -c "from cua_sdk import ComputerAgent; print('OK')"

If you see OK, you're ready to go!

Next: Quickstart