Note: This is the original Amadeus framework. For the vision-first Android automation rebuild, see Amadeus 2.0.
An open-source mobile AI assistant framework that bridges AI decisioning with mobile automation. Amadeus provides the foundation for building AI-powered mobile workflows — from automated testing to intelligent app navigation.
The framework integrates with Android emulators and physical devices via Appium, letting an AI agent see the screen, decide actions, and execute taps/swipes — a pattern later refined in Amadeus 2.0 with vision-first automation.
┌────────────┐ ┌──────────────┐ ┌──────────────┐
│ AI Model │────▶│ Amadeus Core │────▶│ Appium/ADB │
│ (LLM/API) │◀────│ (orchestrator)│◀────│ (executor) │
└────────────┘ └──────────────┘ └──────────────┘
│ │
┌────▼────┐ ┌─────▼─────┐
│ Context │ │ Android │
│ Manager │ │ Device │
└─────────┘ └───────────┘
- Node.js — for Appium and mobile automation tooling
- Python 3 — for automation scripts
- Android Studio — installs the Android SDK + emulator
- Appium — mobile automation engine
# Install Appium + UiAutomator2 driver
npm install -g appium
appium driver install uiautomator2
# Start the server
appium --use-plugins=inspector --allow-cors --allow-insecure=adb_shell- Open Android Studio → AVD Manager → Create Virtual Device
- Choose a hardware profile (e.g., Pixel 4) and system image
- Start the emulator
Or use a physical device: enable Developer Options → USB Debugging → connect.
# Verify device connection
adb devices# Set Android SDK path
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
# Run a workflow
python3 amadeus.py --goal "open settings and enable dark mode"MIT