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

# Installation

> Set up the mobile-use SDK and prerequisites

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:

<AccordionGroup>
  <Accordion title="Python 3.12 or higher" icon="python">
    ```bash theme={null}
    python --version
    # Should be 3.12.x or higher
    ```
  </Accordion>

  <Accordion title="For local Android automation" icon="android">
    * Android SDK Platform Tools (adb)
    * A physical Android device or emulator
  </Accordion>

  <Accordion title="For local iOS automation" icon="apple">
    * A macOS environment
    * Xcode Command Line Tools

    <Tabs>
      <Tab title="Simulator">
        - [idb (iOS Development Bridge) installation](https://fbidb.io/docs/installation/#idb-companion) - Facebook's tool for iOS automation
        - An iOS simulator
      </Tab>

      <Tab title="Physical Device">
        * See [Physical iOS Device Setup](/docs/mobile-use-sdk/physical-ios-quickstart) for detailed instructions
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

## Environment Setup

### 1. Install the SDK

<CodeGroup>
  ```bash pip theme={null}
  pip install minitap-mobile-use
  ```

  ```bash uv (recommended) theme={null}
  # 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
  ```

  ```bash From source theme={null}
  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
  ```
</CodeGroup>

<Note>
  We highly recommend using [UV](https://docs.astral.sh/uv/) for managing your project and packages.
</Note>

### 2. Set Up Device Access

<Tabs>
  <Tab title="Android">
    #### Enable Developer Options

    1. Go to **Settings → About Phone**
    2. Tap **Build Number** 7 times to enable Developer Options
    3. In **Developer Options**, enable **USB Debugging**

    #### Verify ADB Connection

    ```bash theme={null}
    adb devices
    ```

    You should see your device listed.

    <Tip>
      For wireless debugging:

      ```bash theme={null}
      adb tcpip 5555
      adb connect <device_ip>:5555
      ```
    </Tip>
  </Tab>

  <Tab title="iOS">
    #### Connect your iOS device

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

    ```bash theme={null}
    brew install libimobiledevice
    ```

    #### Verify connection

    ```bash theme={null}
    idevice_id -l
    ```
  </Tab>
</Tabs>

## Configuration

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

<Tabs>
  <Tab title="Platform (Recommended)">
    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](/docs/mobile-use-sdk/platform-quickstart#configure-platform-credentials)
  </Tab>

  <Tab title="Local Development">
    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](/docs/quickstart#configure-llm-settings)
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="Platform Quickstart" icon="cloud" href="/docs/mobile-use-sdk/platform-quickstart">
    Complete platform setup and run your first automation (recommended)
  </Card>

  <Card title="Local Quickstart" icon="laptop" href="/docs/mobile-use-sdk/quickstart">
    Complete local setup and run your first automation
  </Card>
</CardGroup>