Troubleshooting

adb kill-server
adb start-server

from minitap.mobile_use.sdk.builders import Builders
from minitap.mobile_use.sdk.types import DevicePlatform

config = (
    Builders.AgentConfig
    .for_device(platform=DevicePlatform.ANDROID, device_id="your_device_id")
    .build()
)
agent = Agent(config=config)

adb shell settings put global adb_timeout 0

# Enable TCP/IP mode
adb tcpip 5555

# Connect wirelessly
adb connect <device_ip>:5555

agent = Agent()

# Kill any existing mobile-use servers
agent.clean(force=True)

# Now initialize
agent.init()

# Check if idb_companion is running
pgrep -l idb_companion

# Start idb_companion if needed
idb_companion --udid booted

# Linux/Mac
lsof -i :8000
lsof -i :8001

# Windows
netstat -ano | findstr :8000
netstat -ano | findstr :8001

agent = Agent()

# Initialize first!
if not agent.init():
    print("Initialization failed")
    exit(1)

# Now you can run tasks
await agent.run_task(goal="Your task")

# ❌ Too complex
await agent.run_task(
    goal="Open settings, go to network, enable airplane mode, "
         "wait 5 seconds, then disable airplane mode"
)

# ✅ Break into steps
await agent.run_task(goal="Open settings and go to network settings")
await agent.run_task(goal="Enable airplane mode")
await asyncio.sleep(5)
await agent.run_task(goal="Disable airplane mode")

task = (
    agent.new_task("Complex goal...")
    .with_max_steps(500)  # Default is 400
    .build()
)

await agent.run_task(request=task)

task = (
    agent.new_task("Your goal")
    .with_trace_recording(enabled=True)
    .build()
)

await agent.run_task(request=task)
# Check traces in mobile-use-traces/ directory

# ❌ Vague
goal = "Check the weather"

# ✅ Specific
goal = "Open the Weather app, check the current temperature in Celsius for New York, and tell me tomorrow's forecast"

from pydantic import BaseModel, Field

class WeatherInfo(BaseModel):
    current_temp: float = Field(
        ..., 
        description="Current temperature in Celsius"
    )
    condition: str = Field(
        ..., 
        description="Current weather condition (sunny, cloudy, rainy, etc.)"
    )
    tomorrow_forecast: str = Field(
        ..., 
        description="Detailed weather forecast for tomorrow"
    )

result = await agent.run_task(
    goal="Check weather for today and tomorrow",
    output=WeatherInfo
)

# ❌ Unclear
goal = "Get product info"

# ✅ Clear
goal = "Go to Amazon, search for 'wireless headphones', open the first result, and get the product name, price, and rating"

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

profile = AgentProfile(
    name="accurate",
    llm_config=LLMConfig(
        cortex=LLMWithFallback(
            provider="openai",
            model="o4-mini",  # More powerful model
            fallback=LLM(provider="openai", model="gpt-5")
        ),
        # ... other components
    )
)

import os
from dotenv import load_dotenv

load_dotenv()  # Explicit load

# Or set programmatically
os.environ["OPENAI_API_KEY"] = "your_key"

from openai import OpenAI

client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
response = client.chat.completions.create(
    model="gpt-5-nano",
    messages=[{"role": "user", "content": "test"}]
)
print("API key works!")

llm_config = LLMConfig(
    planner=LLM(provider="openai", model="gpt-5-nano"),
    cortex=LLM(provider="google", model="gemini-2.5-flash"),
    executor=LLM(provider="openrouter", model="meta-llama/llama-4-scout")
)

import asyncio

for task_goal in task_list:
    await agent.run_task(goal=task_goal)
    await asyncio.sleep(2)  # Brief delay

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

pip list | grep minitap
# Should show: minitap-mobile-use

pip uninstall minitap-mobile-use
pip install minitap-mobile-use

which python
# Should point to your venv

agent.clean(force=True)
agent.init()

# Android
adb devices

# iOS
idevice_id -l

import logging
logging.basicConfig(level=logging.DEBUG)

task = agent.new_task(goal).with_trace_recording(True).build()

adb kill-server
adb start-server