diff --git a/README.md b/README.md
new file mode 100644
index 0000000..41dc111
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# beebot
+BBona
+
+## Installation
+On Linux - run `npm i`
+
+On Windows - ask nuuls (xd).
+Or install node-canvas yourself, see https://github.com/Automattic/node-canvas/wiki/Installation---Windows, then run `npm i`
+
+
+Then copy the `config.default.json` file to `config.json`, enter your credentials and run it with `node index.js`
+
+## Usage
+Add the bot to your discord server with the correct privileges and then run `/bee :emote:`
+The bot spawns an HTTP server on port 3002 on localhost, so you can use that - `http://host/bee?url=<url>`