mobile-use-setup

Mobile-Use SDK Setup

Set up mobile-use so the agent runs locally against a selected device.

Gather Requirements

Ask only for information not already provided:

1. Target: iOS, Android, or both.
2. Device path: local physical device/emulator, BrowserStack, or a Minitap cloud device.
3. LLM provider: Minitap API, OpenAI, Anthropic, Google, OpenRouter, a local model, or another supported provider.

Check Prerequisites

python3 --version  # Requires 3.12+
which uv

# Android local
which adb
adb devices

# iOS simulator
which idb_companion
xcrun simctl list devices

# iOS physical
which idevice_id
which appium
appium driver list

For missing dependencies, use the device-specific reference files in this skill.

Create The Project

uv init <project-name>
cd <project-name>
uv add minitap-mobile-use python-dotenv
cp llm-config.override.template.jsonc llm-config.override.jsonc

Configure the selected provider in llm-config.override.jsonc and put only the required provider keys in .env. Add .env to .gitignore.

Create The Starter

Generate task code that runs the agent locally:

import asyncio

from dotenv import load_dotenv

from minitap.mobile_use.sdk import Agent
from minitap.mobile_use.sdk.builders import Builders
from minitap.mobile_use.sdk.types import AgentProfile

load_dotenv()


async def main() -> None:
    profile = AgentProfile(name="default", from_file="llm-config.override.jsonc")
    config = Builders.AgentConfig.with_default_profile(profile).build()
    agent = Agent(config=config)

    try:
        await agent.init()
        result = await agent.run_task(goal="Your automation goal", name="first-task")
        print(result)
    finally:
        await agent.clean()


if __name__ == "__main__":
    asyncio.run(main())

When selected, extend config with the BrowserStack or for_cloud_device(...) builder API.

Verify

Verify the selected device is visible, then run:

uv run python -c "from minitap.mobile_use.sdk import Agent; print('SDK OK')"
uv run python main.py

Diagnose setup failures from actual command output. Do not silently switch device paths.