Appium + Qirabot

If you already run Appium — local server or a cloud device farm — Qirabot bolts onto the driver you have. Element location becomes AI vision on the screenshot, so Flutter, React Native, WebViews, Unity views, and native screens all automate the same way, with no UiAutomator / XCUITest selector maintenance.

from appium import webdriver
from appium.options.android import UiAutomator2Options
from qirabot import Qirabot

options = UiAutomator2Options()
options.platform_name = "Android"
options.device_name = "emulator-5554"
options.app_package = "com.android.settings"
options.app_activity = ".Settings"
driver = webdriver.Remote("http://localhost:4723", options=options)
bot = Qirabot().bind(driver)

bot.click("Wi-Fi settings")
result = bot.ai("Open Display settings and change font size to Large")
print(f"Success: {result.success}")
bot.close()
driver.quit()

Requires the extra:

pip install "qirabot[appium]"

The same works for iOS drivers (XCUITest options) — Android and iOS Appium sessions are both recognized by bind().

CLI: selecting the Appium engine

Passing --appium-url switches the CLI from the built-in direct backends to your Appium server:

qirabot android "Clear all notifications" --appium-url http://localhost:4723
qirabot ios "..." --device "iPhone 15"      # simulator device type (selects Appium)

Note: the CLI's Appium iOS engine targets simulators (--device is a device type from xcrun simctl list devicetypes). Real iPhones are better served by the WDA-direct backend — no Appium at all.

Recording the device screen

record_device=True uses Appium's session recording API — works for both Android and iOS drivers:

bot = Qirabot(record_device=True).bind(driver)
bot.ai("run through the onboarding flow")
bot.stop_recording()   # call before driver.quit() — the video lives in the session

The video lands in report_dir/recording.mp4 and is embedded in the HTML run report.

Appium or the built-in backends?

	Appium engine	Built-in (adb / WDA)
Server required	yes	no
Device clouds (BrowserStack, Sauce…)	yes	no
Install on device	UiAutomator2/WDA via Appium	nothing (Android) / WDA (iOS)
Extra package	qirabot[appium]	none
Gestures	full Appium set	tap/swipe/keyevent level

Rule of thumb: already invested in Appium or need a device cloud → stay on Appium and add Qirabot on top. Starting fresh on local devices → the Android adb backend and iOS WDA backend are less moving parts.

Related: Android backend · iOS backend