diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3d4a1cf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# mariobot
+This script downloads an image from safebooru macthing the tags given and uploads it to a server using the mastodon api
+
+# Requirements
+[Racket](https://download.racket-lang.org/)
+
+# Usage
+```shell
+racket bot.rkt
+```
+