diff --git a/readme.md b/readme.md
index b25fb36..23e7eeb 100644
--- a/readme.md
+++ b/readme.md
@@ -1 +1,6 @@
-documentation will come soon.
\ No newline at end of file
+# Imagebot
+imagebot is a misskey rgb gaming bot that sends images. currently powering [yaoibot](https://eepykitty.lol/@yaoibot). this bot can easilly be adapted to pull data from elsewhere by replacing image_source.py.
+
+## Usage
+
+wip
\ No newline at end of file