diff --git a/README.md b/README.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..a326cbea8f133d42aff02a0df989b96e6cfdcb39 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,31 @@
+INSTRUCTIONS FOR LINUX
+
+Download CSMOn:
+
+    wget --no-check-certificate https://gitlab.c3sl.ufpr.br/pfperroni/CSMOn/repository/archive.tar.gz?ref=master -O CSMOn.tar.gz
+
+Unpack it:
+
+    tar -xzvf CSMOn.tar.gz
+
+Compile the package:
+
+    cd CSMOn-*
+
+    make
+    
+    make clean
+
+
+The standard PSO implementation is provided with the code.
+
+To run the Python example code:
+
+    cd python
+    
+    python pso_example.py
+    
+
+And to run the C++ example code:
+
+    cpp/pso_example pso -s1 -5.12 -s2 5.12 -w -0.5 -c1 -0.2 -c2 0.35 -n 100 -p 30 -M 50000 -R -0.08
\ No newline at end of file