diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4138092
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# Goobot
+This discord bot reads images sent into a channel
+
+Then provides a /goob command to send a random image among the list of previously recorded images
+
+# Installations instructions
+```bash
+git clone https://github.com/Legonzaur/goobot
+cd goobot
+cp ./src/config.json.example ./src/config.json
+```
+
+edit the config.json file to match your settings 
+
+```bash
+npm i 
+cd goobot
+cp ./src/config.json.example ./src/config.json
+```
\ No newline at end of file
diff --git a/src/config.json.example b/src/config.json.example
new file mode 100644
index 0000000..2bed1e4
--- /dev/null
+++ b/src/config.json.example
@@ -0,0 +1,6 @@
+{
+  "discord_token": "",
+  "discord_app_id": "",
+  "discord_guild_id": "",
+  "owner_id": ""
+}
\ No newline at end of file