diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8148a6c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# searchbot-discord
+**search** - a tiny little search utility bot for discord.
+
+ _To run, rename `config-example.json` to `config.json`. If you want to add more config options, the relevant setup is found in the `init`._
+ 
+ ## Usage:
+ 
+ `@search help` - Find all commands.
+ `@search rejson` - Refresh the list of SearX instances.
+ `@search your term here` - Search for stuff.