CUPI (Computer Use Python Installer)

CUPI (Computer Use Python Installer) enables seamless integration of Claude AI's computer control capabilities without the need for Docker or virtual machines. Run Claude AI directly on your native operating system with just Python.

✨ Features

• 🚀 Native OS support (Windows, MacOS, Linux)
• 💻 Direct system control through Claude AI
• 📝 Automatic conversation logging
• 🖼️ Screenshot capabilities
• 🔍 Web browsing and research
• 📂 File system operations

🔧 Prerequisites

• Python 3.11 or higher
• Claude AI API key
• System permissions for your terminal or Python interpreter

📦 Installation

From PyPI (Recommended)

pip install cupi

From Source

git clone https://github.com/syan-dev/computer-use-python-installer
cd computer-use-python-installer
pip install .

🚀 Quick Start

1. Set your API key:

# Linux/MacOS
export ANTHROPIC_API_KEY=your_api_key_here

# Windows (CMD)
set ANTHROPIC_API_KEY=your_api_key_here

# Windows (PowerShell)
$env:ANTHROPIC_API_KEY="your_api_key_here"

2. Run CUPI:

cupi "Show me the weather in Hanoi"

💡 Example Use Cases

# Web Research
cupi "Open chrome and download the latest blog from Paul Graham"

# System Operations
cupi "Create a new folder named 'projects' and open VS Code there"

# File Management
cupi "Organize my Downloads folder by file type"

# Web Browsing
cupi "Search for recent news about artificial intelligence"

🛠️ Advanced Usage

Custom Configuration

# Set custom log directory
cupi "Take a screenshot" --log-dir "my_logs"

# Use different Claude model
cupi "Browse the web" --model "claude-3-opus"

# Enable verbose output
cupi "Create a file" --verbose

Available Options

--model, -m        Choose Claude model (default: claude-3-5-sonnet)
--log-dir, -l      Set log directory (default: ./logs)
--verbose, -v      Enable detailed output
--max-tokens       Set maximum response tokens
--recent-images    Control number of cached images

📝 Logging

CUPI automatically logs all interactions, including:

• Conversations with Claude
• Screenshots taken
• System operations performed
• Error messages

Logs are stored in JSON format at ./logs by default.

🔒 Security Notes

• CUPI requires system permissions to control your computer
• API keys should be kept secure and never shared
• Review Claude's actions before confirming sensitive operations
• Use environment variables for API keys, never hardcode them

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines before submitting:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

📄 License

This project is licensed under the GPL License - see the LICENSE file for details.

🙏 Acknowledgments

• Anthropic for Claude AI
• All contributors and users of CUPI
• The Python community

📫 Support

• 📚 Documentation
• 🐛 Issue Tracker