Repolode
Submit
alipay

alipay/SoloPi

Open-source mobile test automation tool for recording, replaying, asserting and profiling Android UI flows on real devices, now with an Agent harness.

View on GitHub
Stars
6,364
Forks
1,271
Open issues
140
Last commit
3 days ago

What is it?

SoloPi is an open-source automation tool for mobile app testing. It records taps, inputs, scrolls and assertions on an Android device, then replays them on the same or other devices. It also collects performance data such as CPU, memory, FPS, battery, temperature and network traffic, and can measure cold and warm app startup time.

The project connects to devices over ADB, including wireless debugging, and can drive several phones from one controller device. Recorded flows can be converted to Appium or Macaca scripts through a separate converter project.

The repository also contains solopi-skill, a command-line harness for AI agents. It supports typed dynamic actions that are checked against the current page before execution, independent result judging with passed, failed and not_tested outcomes, and unattended managed runs on a single host. A HarmonyOS version is available on a separate branch.

Key features

  • 01Record and replay UI operations on Android devices without a PC-side recording setup.
  • 02Assert on UI nodes and images during replay.
  • 03Monitor CPU, memory, FPS, battery, temperature and network in real time or as recordings.
  • 04Measure cold and warm startup time.
  • 05Control multiple slave devices from one master device.
  • 06Run typed Agent actions with page-state checks and independent result judging.

Use cases

  • Regression testing of Android app flows on a set of physical phones.
  • Compatibility testing across many devices from a single controller.
  • Measuring app startup and performance under limited CPU, memory or network conditions.
  • Letting an AI agent run device tests with auditable evidence in a CI workflow.

Quick start

  1. 1

    Run the local CLI from source to list actions (no device needed)

    ./solopi-skill/scripts/solopi-ai --pretty actions
  2. 2

    Install the CLI into a virtual environment

    python -m pip install -e ./solopi-skill/scripts/harness
  3. 3

    Build the solopi-app test and debug APK

    ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug

Things to know

  • The open-source device-side implementation supports Android only.
  • Running it requires a real Android device authorized for USB or wireless ADB debugging.
  • The build documentation targets older toolchains such as Android Studio 4.0, Gradle 6.1.1 and NDK 16.
  • The multi-device control feature is not open-sourced yet.

In collections

Android ADB and debloat toolsAndroid apps & phone toolsTesting frameworks & test automation tools

Topics

#android#mobile-testing#ui-testing#test-automation#adb#performance-testing#harmony#arkts#automated-testing#automation

FAQ

What is SoloPi?
Open-source mobile test automation tool for recording, replaying, asserting and profiling Android UI flows on real devices, now with an Agent harness. SoloPi is an open-source automation tool for mobile app testing. It records taps, inputs, scrolls and assertions on an Android device, then replays them on the same or other devices. It also collects performance data such as CPU, memory, FPS, battery, temperature and network traffic, and can measure cold and warm app startup time.
Is SoloPi free to use? What license does it have?
SoloPi is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is SoloPi still maintained?
Actively maintained. The last commit to SoloPi was on Nov 5, 2026.
What can I use SoloPi for?
Regression testing of Android app flows on a set of physical phones. Compatibility testing across many devices from a single controller. Measuring app startup and performance under limited CPU, memory or network conditions. Letting an AI agent run device tests with auditable evidence in a CI workflow.
How do I install SoloPi?
Run the local CLI from source to list actions (no device needed): ./solopi-skill/scripts/solopi-ai --pretty actions Install the CLI into a virtual environment: python -m pip install -e ./solopi-skill/scripts/harness Build the solopi-app test and debug APK: ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug
Where can I get SoloPi?
The source code and installation instructions are on GitHub: https://github.com/alipay/SoloPi

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects