AndroidViewClient is a 100% pure python library and tools that simplifies test script creation providing higher level operations and the ability of obtaining the tree of Views present at any given moment on the device or emulator screen.

android uiautomator viewclient monkeyrunner test automation, android, androidviewclient, automation, monkeyrunner, python, testing, ui
pip install androidviewclient==20.0.0b4



AndroidViewClient was originally conceived as an extension to monkeyrunner but lately evolved as a pure python tool that automates or simplifies test script creation. It is a test framework for Android applications that:

    • Automates driving Android applications
    • Generates re-usable scripts
    • Provides view-based device independent UI interaction
    • Uses 'logical' screen comparison (UI Automator Hierarchy based) over image comparison (Avoiding extraneous detail issues, such as time or data changes)
    • Supports running on multiple devices
    • Provides simple control for high level operations like language change and activity start
    • Supports all Android APIs
    • Is written in python (python 2.7 and python 3.6+ support in 20.x.y)
🛎 A new Kotlin backend is under development to provide more functionality and improve performance.
Take a look at CulebraTester2 and 20.x.y-series prerelease.

Latest Version Pre-release

NOTE: Pypi statistics are broken see here. The new statistics can be obtained from BigQuery.

As of December 2019 we have reached:

culebra 700000 downloads

Thanks to all who made it possible.

Want to learn more?

Detailed information can be found in the AndroidViewClient/culebra wiki