diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ed47284
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# Random Poké
+This Mastodon bot posts random Pokémon cards from the Pokémon TCG universe. 
+
+# Requirements
+- Mastodon.py
+- python-dotenv
+
+# How to use
+- Install the pip requirements above. 
+- Create a ```.env``` file in the same directory including the lines:
+
+      token = ACCESSTOKENHERE
+      url=MASTODONURL
+- Run the bot: ```python bot.py```