Installation

This guide covers the common setup steps for using mobile-use SDK, whether you choose the Platform or Local approach.

Prerequisites

Before installing the Mobile Use SDK, ensure you have the following:

Python 3.12 or higher

python --version
# Should be 3.12.x or higher

For local Android automation

Android SDK Platform Tools (adb)
A physical Android device or emulator

For local iOS automation

A macOS environment
Xcode Command Line Tools

Simulator
Physical Device

idb (iOS Development Bridge) installation - Facebook’s tool for iOS automation
An iOS simulator

Environment Setup

1. Install the SDK

pip install minitap-mobile-use

# Install UV if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a new project
uv init my-mobile-automation
cd my-mobile-automation

# Add mobile-use as a dependency
uv add minitap-mobile-use

git clone https://github.com/minitap-ai/mobile-use.git
cd mobile-use
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv sync

We highly recommend using UV for managing your project and packages.

2. Set Up Device Access

Android
iOS

Enable Developer Options

Go to Settings → About Phone
Tap Build Number 7 times to enable Developer Options
In Developer Options, enable USB Debugging

Verify ADB Connection

adb devices

You should see your device listed.

For wireless debugging:

adb tcpip 5555
adb connect <device_ip>:5555

Connect your iOS device

Connect your iOS device to your Mac
Trust the computer on your iOS device when prompted
Install required dependencies:

brew install libimobiledevice

Verify connection

idevice_id -l

Configuration

After completing the steps above, you’ll need to configure your environment based on which approach you’re using:

Platform (Recommended)
Local Development

The platform approach requires only Minitap Platform credentials:

No LLM config files needed
A single environment variable is required to get started
All LLM configurations managed centrally

Continue to: Platform Quickstart

The local approach gives you full control over LLM configuration:

Create llm-config.override.jsonc file
Configure individual LLM provider API keys
Customize each agent component’s model

Continue to: Local Quickstart

Next Steps

Platform Quickstart

Complete platform setup and run your first automation (recommended)

Local Quickstart

Complete local setup and run your first automation

Overview

Quickstarts

Core Concepts

SDK Reference

Examples

Resources

Prerequisites

Environment Setup

1. Install the SDK

2. Set Up Device Access

Enable Developer Options

Verify ADB Connection

Connect your iOS device

Verify connection

Configuration

Next Steps

Platform Quickstart

Local Quickstart

​Prerequisites

​Environment Setup

​1. Install the SDK

​2. Set Up Device Access

​Enable Developer Options

​Verify ADB Connection

​Connect your iOS device

​Verify connection

​Configuration

​Next Steps

Platform Quickstart

Local Quickstart

Prerequisites

Environment Setup

1. Install the SDK

2. Set Up Device Access

Enable Developer Options

Verify ADB Connection

Connect your iOS device

Verify connection

Configuration

Next Steps