# Airtest Project

UI Automation Framework for Games and Apps

Repository: https://github.com/AirtestProject/Airtest
Canonical: https://ross.abutalabs.com/products/airtest-project
Homepage: http://airtest.netease.com/
Language: Python
License: Apache-2.0
License Family: permissive
Topics: automated-testing, game, unity3d, android, automation, test-automation, test-framework, ios, windows
Last push: 2026-03-23T09:16:49+00:00
Link (homepage): http://airtest.netease.com/
Link (site_page): https://airtest.doc.io.netease.com/en
Link (site_page): https://airtest.netease.com/changelog.html
Link (site_page): https://airtest.netease.com/docs/en/1_quick_start/5_get_started_with_web_test.html

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 73, release rhythm 35, longevity 100
- inputs: {"age_days": 3143, "days_push": 163, "days_rel": 272, "gap_med": 113, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9532, forks 1448 (observed 2026-08-28T04:10:31.722021+00:00)

## What it is
Airtest Project is a cross-platform UI automation testing framework from NetEase for games and apps, using image recognition to locate UI elements without code injection. It includes the Poco framework for UI-hierarchy-based automation across engines like Unity3D, Cocos2d-x, and UE4, plus AirtestIDE for recording and running test cases.

## Use cases
- automate testing of mobile games on android and ios
- ui automation for unity3d games without injecting code
- write once run anywhere automated tests for apps and games
- generate html test reports with screenshots for failed cases
- automate windows desktop application testing with python
- run automated test cases across a large device farm
- record and replay ui automation scripts in an ide

## When to choose
- you need to automate games or apps where you cannot access the source code or UI hierarchy
- you want cross-platform test scripts covering Android, iOS, Windows, and game engines from one Python codebase
- you prefer image-recognition-based element location over accessibility-based selectors
- you want an IDE with script recording, running, and HTML reporting in one workflow

## When to avoid
- you only need web browser testing, where Selenium or Playwright are more mature choices
- you need pure unit or API-level testing rather than UI automation
- your team is not comfortable with Python-based scripting
- you require lightweight CI-only tooling without a GUI IDE dependency

## Facets
- artifact type: framework
- maturity: active
- function: testing, e2e-testing, workflow-automation, image-processing, gui
- domain: testing, mobile-development, developer-tools
- platform: python, windows, cross-platform, cli
- tags: ui-automation, game-testing, image-recognition, poco, airtestide, unity3d, appium-alternative, device-farm, game-development, automation, android, ios

## Member repositories
- AirtestProject/Airtest (main) score 65
- AirtestProject/Poco (plugin) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:31.722021+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:21:58.905482+00:00, confidence not recorded.
  - readme: https://github.com/AirtestProject/Airtest (fetched 2026-08-28T04:10:31.722021+00:00, sha 0f59b8143283)
  - homepage: http://airtest.netease.com/ (fetched 2026-08-29T08:22:11.156406+00:00, sha d249e7461303)
  - site_page: https://airtest.netease.com/docs/en/1_quick_start/5_get_started_with_web_test.html (fetched 2026-08-29T08:22:11.170558+00:00, sha cf11184f90eb)
  - registry_pypi: https://pypi.org/pypi/airtest/json (fetched 2026-08-29T08:22:11.172317+00:00, sha 8c57e5d6f324)
  - site_page: https://airtest.doc.io.netease.com/en (fetched 2026-08-29T08:22:11.165711+00:00, sha cf11184f90eb)
  - site_page: https://airtest.netease.com/changelog.html (fetched 2026-08-29T08:22:11.167805+00:00, sha 608c0a23e2ce)
- Data as of 2026-08-30T08:39:29.467469+00:00.