diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2933796
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# hangman-solver-py
+Simple Hangman Solver using bruteforce and an english dictionary.
+
+It uses the elimination method to give you hints about likely words. Most effective with lengthy words.
+ - Uses input information such as right letters, wrong letters, position and repetition.