Types

Reference for core types and data structures used in the mobile-use SDK.

AgentProfile

Represents a profile for the mobile-use agent with LLM configuration.

from minitap.mobile_use.sdk.types import AgentProfile

Constructor

AgentProfile(
    *,
    name: str,
    llm_config: LLMConfig | None = None,
    from_file: str | None = None,
)

str

required

Name of the profile

LLMConfig

LLM configuration for the agent

str

Path to a file containing LLM configuration (JSONC format)

llm_config and from_file are mutually exclusive - use only one.

Examples

# From file
profile = AgentProfile(
    name="default",
    from_file="llm-config.defaults.jsonc"
)

# Programmatic
from minitap.mobile_use.config import LLM, LLMConfig

profile = AgentProfile(
    name="custom",
    llm_config=LLMConfig(
        planner=LLM(provider="openai", model="gpt-5-nano"),
        cortex=LLM(provider="openai", model="gpt-5"),
        # ... other components
    )
)

TaskRequest

Represents a mobile automation task request.

from minitap.mobile_use.sdk.types import TaskRequest

Attributes

str

Natural language description of the task goal

str | None

Name of the agent profile to use

str | None

Name of the task for logging

str | None

Description of the expected output format

type[TOutput] | None

Pydantic model class for typed output

int

Maximum number of steps the agent can take

bool

Whether to record execution traces

Path

Directory to save trace data

Path | None

Path to save LLM outputs

Path | None

Path to save agent thoughts

Usage

TaskRequest objects are typically created via TaskRequestBuilder:

task_request = (
    agent.new_task("Your goal")
    .with_name("task_name")
    .build()
)

AgentConfig

Configuration for the agent.

from minitap.mobile_use.sdk.types import AgentConfig

Created via AgentConfigBuilder:

config = (
    Builders.AgentConfig
    .with_default_profile(profile)
    .build()
)

agent = Agent(config=config)

DevicePlatform

Enum for device platforms.

from minitap.mobile_use.sdk.types import DevicePlatform

# Available values
DevicePlatform.ANDROID
DevicePlatform.IOS

Usage

config = (
    Builders.AgentConfig
    .for_device(platform=DevicePlatform.ANDROID, device_id="emulator-5554")
    .build()
)

ServerConfig

Configuration for agent servers.

from minitap.mobile_use.sdk.types import ServerConfig

Attributes

str

ADB server host

int

ADB server port

Usage

servers = ServerConfig(
    adb_server_host="localhost",
    adb_server_port=5037
)

config = Builders.AgentConfig.with_servers(servers).build()

LLMConfig

Configuration for LLM models used by different agent components.

from minitap.mobile_use.config import LLM, LLMConfig, LLMConfigUtils, LLMWithFallback

Structure

llm_config = LLMConfig(
    planner=LLM(provider="openai", model="gpt-5-nano"),
    orchestrator=LLM(provider="openai", model="gpt-5-nano"),
    cortex=LLMWithFallback(
        provider="openai",
        model="gpt-5",
        fallback=LLM(provider="openai", model="gpt-5")
    ),
    executor=LLM(provider="openai", model="gpt-5-nano"),
    utils=LLMConfigUtils(
        hopper=LLM(provider="openai", model="gpt-5-nano"),
        outputter=LLM(provider="openai", model="gpt-5-nano")
    )
)

Components

planner

Creates high-level plans from goals

orchestrator

Coordinates execution steps

cortex

Visual understanding and decision-making

executor

Performs specific actions

hopper

Extracts relevant information from large data batches

outputter

Extracts structured output

LLM

Basic LLM configuration.

from minitap.mobile_use.config import LLM

llm = LLM(provider="openai", model="gpt-5")

str

required

Provider name: openai, google, xai, openrouter

str

required

Model identifier (e.g., gpt-5, gemini-2.5-flash)

LLMWithFallback

LLM configuration with a fallback model.

from minitap.mobile_use.config import LLM, LLMWithFallback

llm = LLMWithFallback(
    provider="openai",
    model="o4-mini",
    fallback=LLM(provider="openai", model="gpt-5")
)

If the primary model fails, the fallback is used automatically.

TaskRequestCommon

Common configuration shared across tasks.

from minitap.mobile_use.sdk.types import TaskRequestCommon

Created via TaskDefaults builder:

defaults = (
    Builders.TaskDefaults
    .with_max_steps(500)
    .build()
)

Overview

Quickstarts

Core Concepts

SDK Reference

Examples

Resources

AgentProfile

Constructor

Examples

TaskRequest

Attributes

Usage

AgentConfig

DevicePlatform

Usage

ServerConfig

Attributes

Usage

LLMConfig

Structure

Components

planner

orchestrator

cortex

executor

hopper

outputter

LLM

LLMWithFallback

TaskRequestCommon

Next Steps

Agent SDK

Exceptions

​AgentProfile

​Constructor

​Examples

​TaskRequest

​Attributes

​Usage

​AgentConfig

​DevicePlatform

​Usage

​ServerConfig

​Attributes

​Usage

​LLMConfig

​Structure

​Components

planner

orchestrator

cortex

executor

hopper

outputter

​LLM

​LLMWithFallback

​TaskRequestCommon

​Next Steps

Agent SDK

Exceptions

AgentProfile

Constructor

Examples

TaskRequest

Attributes

Usage

AgentConfig

DevicePlatform

Usage

ServerConfig

Attributes

Usage

LLMConfig

Structure

Components

LLM

LLMWithFallback

TaskRequestCommon

Next Steps