Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Cross-platform Robot Framework library for GUI automation based on image recognition

Project Description

This Robot Framework library provides the facilities to automate GUIs based on image recognition similar to Sikuli. This library wraps pyautogui to achieve this.

Keyword documentation

Keyword Documentation

Travis CI

Travis CI


On OS X, Retina display might double all coordinates from what they are suppose to be. Unfortunately you need to work around this problem yourself.

On Ubuntu, you need to take special measures to make the screenshot functionality to work correctly. The keyboard functions might not work on Ubuntu when run in VirtualBox on Windows.



If you have pip, installation is straightforward, although you need to explicitly install pillow first:

$ pip install pillow
$ pip install robotframework-imagehorizonlibrary

This will automatically install dependencies as well as their dependencies.


ImageHorizonLibrary should work on Windows “out-of-the-box”. Just run the commands above to install it.


You additionally need to install these for pyautogui:

$ pip install pyobjc-core pyobjc

For these, you need to install XCode


You additionally need to install these for pyautogui:

$ sudo apt-get install python-dev python-xlib
$ sudo pip install pillow

You might also need, depending on your Python distribution, to install:

$ sudo apt-get install python-tk

If you are using virtualenv, you must install python-xlib manually to the virtual environment for pyautogui:

Running tests

$ python tests/utest/ [verbosity=2]


$ python tests/atest/

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(11.6 kB) Copy SHA256 Hash SHA256
Source None Dec 10, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting