Skip to content

About

A powerful, native Python library for Windows automation, featuring Context Manager-based asynchronous chaining, advanced human-like physics, and zero dependence on heavy automation libraries. It leverages native ctypes hooks for maximum speed, security, and lower overhead.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Advanced Automation Utilities

Version Python version Windows version Total downloads Sponsor

A powerful, native Python library for Windows automation, featuring Context Manager-based asynchronous chaining, advanced human-like physics, and zero dependence on heavy automation libraries. It leverages native ctypes hooks for maximum speed, security, and lower overhead.

Purpose

This library is designed for scripts and applications that need:

  • Reliable, human-like mouse movements natively in Windows.
  • Low-level keyboard hooks and precise inputs.
  • Fast and accurate screen vision (OCR and image matching).
  • Asynchronous execution and method chaining.
  • Reliable timing, sound, and system-level operations.

Requirements

Dependencies

  • mss (v10.2.0 or higher)
  • numpy (v2.2.0 or higher)
  • opencv-python (v4.10.0 or higher)
  • psutil (v6.0.0 or higher)
  • tui_utilities (v1.9.17 or higher)
  • winrt-Windows.Foundation (v3.2.0 or higher)
  • winrt-Windows.Foundation.Collections (v3.2.0 or higher)
  • winrt-Windows.Graphics.Imaging (v3.2.0 or higher)
  • winrt-Windows.Media.Ocr (v3.2.0 or higher)
  • winrt-Windows.Storage.Streams (v3.2.0 or higher)

Optional dependencies

  • hypothesis (v6.47.4 or higher)
  • pre-commit (v3.2.0 or higher)
  • pytest (v7.2.0 or higher)
  • pytest-cov (v6.0.0 or higher)

Note

Standard library modules are used where possible; only external dependencies are listed.

Setuptools version

Setuptools 77.0 or higher

Python version

Python 3.15 or higher

Operating System

Windows 10 or higher.

Installation

  • Install:

    pip install advanced_automation_utilities
  • Show:

    pip show advanced_automation_utilities
  • Update:

    pip install -U advanced_automation_utilities
  • Uninstall:

    pip uninstall -y advanced_automation_utilities

Import

from advanced_automation_utilities import (
    Mouse, MouseInfo, MousePhysics,
    Keyboard, KeyboardInfo, KeyboardPhysics,
    Screen, ScreenInfo,
    Timing, TimingInfo,
    Sound,
    System, SystemInfo
)

Features

The full documentation, API references, and examples are in the GitHub Wiki.

Choose a section to explore:

  • Mouse: movement, clicks, scrolling and physics.
  • Keyboard: typing, hotkeys, blocking and physics.
  • Screen: OCR text reading, image location, and pixel colors.
  • Timing: smart delays, random delays, and performance measuring.
  • Sound: system sounds, TTS and audio files.
  • System: process management, window management and kill-switch.
  • Asynchrony: non-blocking parallel executions.
  • Physics: human-like mouse and keyboard behaviors.
  • Exceptions: library-specific errors.

Support

If you found this library helpful in your projects, consider buying me a coffee! It helps support the ongoing development, maintenance, and the creation of more open-source tools.

Sponsor

About

A powerful, native Python library for Windows automation, featuring Context Manager-based asynchronous chaining, advanced human-like physics, and zero dependence on heavy automation libraries. It leverages native ctypes hooks for maximum speed, security, and lower overhead.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Sponsor this project

Used by

Contributors

Languages