diff --git a/README b/README
new file mode 100644
index 0000000..0a5eadd
--- /dev/null
+++ b/README
@@ -0,0 +1,18 @@
+======
+Flake8
+======
+
+Flake8 is just a merge of the PyFlakes and the pep8 projects into one single
+script.
+
+It runs both tests by launching the single 'flake8' script, and also adds a 
+few features:
+
+- lines that contains a "# NOQA" comment at the end will not issue a warning
+- more things to come..
+
+Original projects:
+
+- pep8: http://github.com/jcrocholl/pep8/
+- PyFlakes: http://divmod.org/trac/wiki/DivmodPyflakes
+
diff --git a/setup.py b/setup.py
index 4e73ccd..ccdef52 100755
--- a/setup.py
+++ b/setup.py
@@ -1,5 +1,7 @@
 from distutils.core import setup
 
+README = open('README').read()
+
 setup(
     name="flake8",
     license="MIT",