diff --git a/README.md b/README.md
index a8e05d9..d9f3403 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,26 @@
 # AVR_ASM
 
-Some example code for interacting with a Atmegr328P using assembly and the avra assembler program.
-
+Some example code for interacting with a Atmegr328P using assembly and the 
+avra assembler program.
+
+This program just runs a simple led chaser dependant on the value stored 
+at a sram address.
+
+
+## How to run:
+
+**requirements:**
+- avra assembler
+- the avr inc files or change the makefile to target the included one.
+- an avrasp programmer.
+- gnu make
+- bash
+
+
+```sh
+git clone <REPO URL>
+cd <REPO>
+make all
+make flash
+```
+