OAGI Python SDK is a Python client library for the Lux computer-use model that turns Lux into a programmable automation layer for operating human-facing software via vision and actions. It exposes the OAGI API in an ergonomic way, letting you trigger Lux in three main modes: Tasker for precise scripted sequences, Actor for fast one-shot tasks, and Thinker for open-ended, multi-step objectives. The SDK is designed around “computer use” as a paradigm, where the AI actually navigates interfaces, clicks, types, scrolls, and reads the screen through screenshots instead of only calling APIs. It provides high-level asynchronous agents (like AsyncDefaultAgent and AsyncActor) that encapsulate the loop of capturing screenshots, sending them to Lux, interpreting responses, and executing UI actions with PyAutoGUI. Multiple installation flavors let you choose between a minimal oagi-core package or variants that bundle desktop automation and FastAPI/Socket.IO server capabilities.
Features
- Python SDK for the Lux computer-use API with Tasker, Actor, and Thinker modes
- Asynchronous agents that coordinate screenshots, model calls, and PyAutoGUI actions
- Flexible install profiles (oagi, oagi-core, desktop extras, server extras) for different deployment needs
- Rich CLI tooling to run agents, inspect modes, manage permissions, and export execution history
- Built-in image processing utilities for screenshot compression and resizing before API calls
- Optional FastAPI and Socket.IO server layer for real-time browser and remote integration