diff --git a/README.md b/README.md
new file mode 100644
index 0000000..35b023b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+Installation
+=============
+
+Make sure your virtualenv is up to date (had troubles with html5lib).
+
+Create and activate your venv.
+
+     virtualenv venv
+     source venv/bin/activate
+
+Install python dependencies with pip
+
+     pip install pillow html5lib mwclient
+