diff --git a/HashCracker/README.md b/HashCracker/README.md
new file mode 100644
index 0000000..c74e1f3
--- /dev/null
+++ b/HashCracker/README.md
@@ -0,0 +1,51 @@
+# Hashcracking Code
+
+"Solutions" for the hash cracking tasks.
+Implemented as Unit-tests
+
+## Instlling
+
+YOu need to install some libraies,  I would recommend using a virtual env
+
+### Setup Env
+
+(You only need to do this once
+
+```
+$python3 -m venv env
+```
+
+### Activate
+
+On Linux
+
+```
+source env/scripts/activate
+```
+
+On Windows
+
+```
+env\scripts\activate.bat
+
+#Or 
+
+env\scripts\activate.ps1
+```
+
+### Install Dependencies
+
+```
+pip insall -r REQUIREMENTS.txt
+```
+
+NOTE: Depending on your python version bcrypt can be insteresting to install
+
+  - update pip  ```pip install --upgrade pip```
+  - RFTM (https://pypi.org/project/bcrypt/)
+
+## Running the tests
+
+```
+pytest -v
+```
diff --git a/HashCracker/REQUIREMENTS.txt b/HashCracker/REQUIREMENTS.txt
new file mode 100644
index 0000000..59023c7
--- /dev/null
+++ b/HashCracker/REQUIREMENTS.txt
@@ -0,0 +1,2 @@
+pytest
+bcrypt