diff --git a/README.md b/README.md
index 731f6a2f79038b7eb40ea593d0cb1c43df05b4ef..ab8d0cf4c6f5817161b89cc3a3c00cb4097c5b7d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,14 @@
 # ippidb-web
 
 This repository contains the django web application that manages the iPPI-DB
-database. 
\ No newline at end of file
+database. 
+
+## run flake8 before commit
+From the root of the project:
+```
+. .venv/bin/activate
+pip install -q flake8
+flake8 --install-hook git
+git config --bool flake8.strict true
+ln -s ippisite/.flake8 .flake8
+```
\ No newline at end of file