# asweigart/pyautogui

A cross-platform GUI automation Python module for human beings. Used to programmatically control the mouse & keyboard.

Repository: https://github.com/asweigart/pyautogui
Canonical: https://ross.abutalabs.com/products/pyautogui
Language: Python
License: BSD-3-Clause
License Family: permissive
Last push: 2024-08-20T18:34:57+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4430, "days_push": 743, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12668, forks 1435 (observed 2026-08-28T04:10:59.532127+00:00)

## What it is
PyAutoGUI is a cross-platform Python module for GUI automation that programmatically controls the mouse and keyboard. It works on Windows, macOS, and Linux and supports tasks like clicking, typing, and screen-based interaction.

## Use cases
- automate repetitive mouse clicks and keyboard input
- write scripts to control the mouse cursor programmatically
- automate GUI testing of desktop applications
- simulate keystrokes and hotkeys in Python
- build simple RPA bots for desktop apps
- automate form filling or clicking through UIs

## When to choose
- you need cross-platform desktop GUI automation from Python
- you want a simple, well-documented API for mouse and keyboard control
- you're automating apps with no scripting or API interface

## When to avoid
- you need to automate web browsers specifically (use Selenium or Playwright)
- you require multi-monitor support or high-reliability enterprise RPA
- you need image-recognition-heavy automation at scale

## Facets
- artifact type: library
- maturity: stable
- function: gui, workflow-automation, testing
- domain: developer-tools, cross-platform
- platform: windows, python, cross-platform
- tags: gui-automation, mouse-control, keyboard-control, rpa, desktop-automation, automation, macos, linux

## Member repositories
- asweigart/pyautogui (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:59.532127+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:13:52.831165+00:00, confidence not recorded.
  - readme: https://github.com/asweigart/pyautogui (fetched 2026-08-28T04:10:59.532127+00:00, sha 9e7d4e7ece1e)
  - registry_pypi: https://pypi.org/pypi/pyautogui/json (fetched 2026-08-29T08:10:10.788905+00:00, sha 2cbd4263baef)
- Data as of 2026-08-30T08:39:29.467469+00:00.