> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Lux

> Use Lux computer-use agents to control iPhones with TapKit

TapKit integrates with [Lux](https://agiopen.org), the computer-use model from OpenAGI Foundation, enabling AI agents to control iPhones through visual understanding and action execution.

The integration provides drop-in replacements for the standard OAGI SDK components:

* **TapKitAsyncActionHandler** - Replaces `AsyncPyautoguiActionHandler` to execute actions on the phone
* **TapKitAsyncImageProvider** - Replaces `AsyncScreenshotMaker` to capture phone screenshots

## Installation

```bash theme={null}
pip install tapkit
```

## Quick Start

```python theme={null}
import asyncio

from oagi import AsyncDefaultAgent
from tapkit import TapKitClient
from tapkit.oagi import TapKitAsyncActionHandler, TapKitAsyncImageProvider

async def main():
    # Connect to your phone
    client = TapKitClient()
    phone = client.phone("my-phones-name")

    # Set up TapKit providers for Lux
    image_provider = TapKitAsyncImageProvider(phone=phone)
    action_handler = TapKitAsyncActionHandler(phone=phone)

    # Create and run the agent
    agent = AsyncDefaultAgent(
        model="lux-actor-1",
        max_steps=20
    )

    await agent.execute(
        instruction="Open up messages and text Edgar that we're going on the boat tomorrow.",
        action_handler=action_handler,
        image_provider=image_provider
    )

asyncio.run(main())
```

## Supported Actions

The TapKit action handler supports the following Lux action types:

| Action         | Phone Behavior                 |
| -------------- | ------------------------------ |
| `CLICK`        | Tap at coordinates             |
| `LEFT_DOUBLE`  | Double tap                     |
| `RIGHT_SINGLE` | Long press (2 second hold)     |
| `DRAG`         | Drag from one point to another |
| `TYPE`         | Type text                      |
| `SCROLL`       | Flick in a direction           |
| `WAIT`         | Pause for 3 seconds            |
| `FINISH`       | Reset handler state            |
| `CALL_USER`    | Request user intervention      |

## Learn More

For more on Lux models, execution modes, and the OAGI SDK, see the [OpenAGI Developer Documentation](https://developer.agiopen.org/docs).