Ok Script

This is an open source Python framework for building computer vision automation tools, aimed mainly at games. A developer writes tasks in Python that capture the screen, recognize what is shown, decide what to do and send mouse, keyboard or touch input. The same task code can drive a Windows application window, an Android emulator or a device connected over ADB. The recognition toolkit covers template matching with OpenCV, OCR, and optional object detection such as YOLO. Template images are managed in COCO annotation format and scale automatically to the screen resolution. The framework also provides screenshot and input handling, a visual debugging overlay, automated testing, packaging through GitHub Actions, installer publishing, online incremental updates and multi language interfaces. It runs headless by default, with optional extras for a Qt desktop interface, a FastAPI browser interface, ADB and OCR, and it requires Python 3.11 or newer. It installs from PyPI and the project documentation is written primarily in Chinese, with English and Traditional Chinese versions of the site and README. It is intended for developers and hobbyists who want to build their own automation tools. A template project and a Python key automation tool are provided as starting points, and the project site lists community built automation projects for specific games, among them Wuthering Waves, Genshin Impact, Honkai Star Rail, Girls' Frontline 2 and Onmyoji. The software is free and released under the AGPL 3.0 license. Because its purpose is to automate games, using it or the game specific projects built on it may conflict with a game's own terms of service, and users should check those terms before running automation against a game.