Table of Contents
May 2, 2025

How to Power Mobile Test Automation with Appium + Pytest

Set up Appium with Pytest for fast, modular mobile test automation. Learn tools, structure, and tips to streamline Android and iOS testing workflows.
How to Power Mobile Test Automation with Appium + Pytest
Pavitra Kinni
Pavitra KinniSoftware Engineer in Testing - II

While Appium is a go-to for mobile automation and Pytest is a favorite in the Python ecosystem, using them together is surprisingly rare. This article breaks down why this combo is powerful, how we made it work, and how you can, too.

Why Appium + Pytest?

  • Appium gives cross-platform mobile automation (Android/iOS)
  • Pytest offers elegant test writing, fixtures, and plugin support
  • Most teams use Appium with Java/TestNG — but if your stack is Python-heavy, Pytest is a perfect fit

Use case at our org: We needed mobile UI + API integration tests running inside a unified framework. Pytest gave us modularity and speed, while Appium handled real device automation.

Pre-requisites for Appium + Pytest Setup on Mac

1. Install Homebrew (if not already installed)

Homebrew helps install packages easily on Mac.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Python 3

brew install python

 3. Install Pip and Virtual Environment

python3 -m ensurepip --upgrade

Create and activate a virtual environment (recommended):

python3 -m venv venv

source venv/bin/activate

4. Install Appium Server

You can install Appium globally using npm (Node Package Manager).
First, install Node.js: brew install node
Then install Appium: npm install -g appium
Verify Appium: appium -v

5. Install Appium Doctor

To check your environment setup easily:
npm install -g appium-doctor
appium-doctor

6. Install Android Studio

7. Install Appium-Python-Client and Pytest

Inside your virtual environment: pip install Appium-Python-Client pytest
Optional but useful: pip install pytest-xdist pytest-html

8. Enable Developer Mode on Your Mobile Device    (Android or iOS)

If you are using a physical device:

  • Enable Developer Options and USB Debugging (Android).

  • For iOS, configure WebDriverAgent (more setup needed).

9. Start Appium Server

Run via Terminal: appium

10. ADB Devices Check (Android)

Verify that your device/emulator is connected: adb devices

You should see your device ID listed.

After Setup

You’ll be ready to:

    • Launch Appium server
    • Connect an emulator or device
    • Run pytest-based test cases using Appium driver sessions!

Directory structure:

mobile_automation/

├── tests/

│   └── test_demow.py

├── pages/

│   └── demo_page.py

├── utils/

│   └── driver_setup.py

├── conftest.py


 1. driver_setup.py

 2. conftest.py (with Pytest Fixture)

3. Page Object: demo_page.py

4. Test File: test_demo.py

5. Command to run the pytest file: pytest -vs tests/test_demo.py(pytest with the relative path)

output of pytest

Challenges and Solutions

  • Issue: pytest not detecting Android environment
  • Fix: Ensure pytest runs from the project root with PYTHONPATH= pytest
  • Issue: Flaky UI loading
  • Fix: Added explicit waits and fallback API validations

The Benefits of This Stack

  • Unified Python automation for web + mobile + API
  • Reusable Pytest fixtures
  • Super fast local debugging
  • Easily scalable with Allure reports

Final Thoughts

Appium + Pytest might not be the default combo, but it can be the perfect fit for teams looking to unify their testing across layers. With good structure and the right fixtures, it’s fast, flexible, and fun to work with

Book a Discovery Call.

SHARE ON

Articles

Dive deep into our research and insights. In our articles and blogs, we explore topics on design, how it relates to development, and impact of various trends to businesses.