[](https://github.com/oculix-org/Oculix)
# SikuliX1
### *Historical SikuliX1 codebase β mirrored under oculix-org.*



---
## π― Where you probably want to go
| You want to⦠| Go to |
|---|---|
| **Use SikuliX today** | π **[oculix-org/Oculix](https://github.com/oculix-org/Oculix)** β the active fork. Java 17+, current releases (`v3.0.3` stable, `v4.0` in flight). |
| **Report a bug or request a feature** | π **[oculix-org/Oculix/issues](https://github.com/oculix-org/Oculix/issues)** |
| **Read the public documentation** | π **[docs.oculix.org](https://docs.oculix.org)** |
| **See RaiMan's original upstream** | π [RaiMan/SikuliX1](https://github.com/RaiMan/SikuliX1) β archived March 2026 by its creator |
| **Browse the legacy SikuliX1 code** | You're here. Read-only mirror. |
---
## What is SikuliX (briefly)
SikuliX uses **computer vision** ([OpenCV](https://opencv.org/)) to identify and interact with anything visible on a screen β Windows, macOS, Linux. It locates GUI elements through image recognition, then drives them with simulated mouse and keyboard input. No access to source code, DOM, or accessibility APIs required.
The original motto, still valid : *"If you can see it, you can automate it."*
For the modern continuation with OpenCV 4.10 (via Apertix), Java 17+, working VNC stack, Android 12+ ADB, PaddleOCR option, and 22 native-reviewed locales β **[oculix-org/Oculix](https://github.com/oculix-org/Oculix)**.
---
## π Heritage
A 23-year lineage of MIT-licensed open work :
- **2003 Β· MIT CSAIL** β Rob Miller's UI Design Group launches the visual automation research project that would become Sikuli.
- **2009 Β· UIST paper** β [**@doubleshow**](https://github.com/doubleshow) (Tom Yeh) and [**@vgod**](https://github.com/vgod) (Tsung-Hsiang Chang) formally introduce Sikuli at the ACM Symposium on User Interface Software and Technology. The codebase eventually lands under the [sikuli](https://github.com/sikuli) GitHub organization.
- **2010β2023 Β· SikuliX1** β [**@RaiMan**](https://github.com/RaiMan) (Raimund Hocke) takes over as sole maintainer, evolving the project through Java 8 β 11, multi-platform fixes, OCR integration, and 13 years of patient stewardship.
- **March 2026 Β· oculix-org** β RaiMan archives the upstream and transmits stewardship; active development continues as **OculiX**.
Massive gratitude to all four β without them, this project simply doesn't exist. The MIT license they chose 23 years ago is still in place today, and that's not an accident.
---