diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d72aa41
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# GoPass
+An easy to use command-line password generator that creates secure passwords
+
+# Usage:
+<code>./gopass [number of characters]</code><br>
+<hr>
+eg:
+<code>./gopass 32</code><br>
+output: <code>E$bGOiiPASS*,ISl{!MJ&<\[COOL0eVw</code>
\ No newline at end of file