Compare websites to images of websites and spots the difference.

pip install eukalypse==0.1.3



Travis CI Build Status

Eukalypse is a library for automated visual regression tests for websites. It serves 2 main goals:

  • create screenshots of websites - boring
  • create screenshots of websites and compare these to an expected outcome - interesting!!

Feature 2 can be used in and a testing environment: "is everything as i expect it to be?" Technical speaking: Are the pixels of the current generated screenshot of a website the same as in the reference screenshot I created and verified in advance. You can write tests using Eukalypse to verify your expectations.

If you dont want to write tests or maintain a testing system yourself, you can use eukalypse_now. It is a turnkey ready standalone server for automated visual regression tests.

And dont worry. I know content changes are pixel changes as well. Sometimes these changes needed to be tracked, sometimes they do not. You can use the experimental feature of image masks to ignore changes in the masked areas.

You can supply features, bugs and patches at github: https//

Python support

Right now, eukalypse does not support python 3.2 or jython. Its close! Mostly due to problems in third party libraries. It does however support the following:

  • python 2.6
  • python 2.7
  • pypy

If anyone knows how to make it run on python 3.2 or jython: Tell me!


Eukalypse can be used to create one or more screenshots, compare screenshots with reference images and, in addtion, can execute selenium testing code beforehand to create the state in the application you want to check.

You need a running selenium server somewhere. In this examples, it is asumed the server is running on localhost and the development test webserver is running on localhost as well.


create a screenshot (short version)

e = Eukalypse()
screenshot = e.screenshot('test', 'http://localhost:8400/')


compare a website with a reference image

e = Eukalypse()
eukalypse_result_object ='test', 'my_reference_image.png', 'http://localhost:8400/')
if eukalypse_result_object.clean:
    print "the same!"
    print "different!"

For now, please take a look at the files in the docs folder, the examples or the testing suit for and indepth usage.