🚀 appium-client-python

appium-client-python is a modern, high-level, human-readable mobile automation client for Python 3.11+. Built on top of Appium 2.x and PyTest, it delivers zero-boilerplate mobile testing with intelligent locator resolution, auto-healing, smart synchronization, and built-in failure diagnostics.

✨ Key Features

🎯 Zero Boilerplate: Write clean, expressive mobile tests with fluent element APIs.
🧠 Intelligent Locators: Automatic multi-tier scoring (Accessibility ID > Text > Resource ID > Relative position) with auto-scrolling.
📱 Device Auto-Resolution: Automatic ADB / Simulator detection, port forwarding, and session management.
⚡ Screen Object Model (SOM): First-class support for state-verified screen transitions.
🛡️ Built-in Resilience: Self-healing locators, auto-wait synchronization, and graceful error handling.
📸 Diagnostics & Evidence: Automatic failure screenshots, screen recording, and ADB crash log capture.

📦 Installation

pip install appium-client-python

🚀 Quick Start

1. Initialize a New Project

appium_client setup --project_folder my_mobile_tests
cd my_mobile_tests

2. Write a Simple Test

# tests/test_login.py
def test_user_login(mobile):
    mobile.launch_app("com.example.myapp")
    
    mobile.input("Username").fill("admin@example.com")
    mobile.input("Password").fill("Secret123!")
    mobile.button("Log In").tap()
    
    assert mobile.is_visible("Welcome, Admin!")

3. Run Tests with PyTest

pytest tests/ -v

📖 Comprehensive Documentation

For the full architectural guide, Screen Object Model patterns, relational locators, and complete API tables, refer to README_original.md or the docs/ folder.

📄 License

Distributed under the MIT License.

Metadata

Release files for appium-client-python 1.3.35

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for appium-client-python 1.3.35
File	Interpreter	ABI	Platform	Reset
appium_client_python-1.3.35-cp314-cp314-win_amd64.whl 5.4 MB Aug 26, 2026	CPython 3.14	CPython 3.14	Windows x86-64	Details

Release files / appium_client_python-1.3.35-cp314-cp314-win_amd64.whl

Download URL	appium_client_python-1.3.35-cp314-cp314-win_amd64.whl
Size	5.4 MB
Tags	CPython 3.14 Windows x86-64
SHA-256 checksum How to use checksums	`172805a16ff3e1743920f94f2230d134a97e51a4d76808a6a1eb02aaa6d1b298`
BLAKE2b-256 checksum How to use checksums	`779a438873fd70c919b894758a805f6267eb6ecde95ffd7b6020ef4b199f8d89`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`