diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1ca6076
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+buypeeb
+===
+
+buypeeb is a program for a certain mini wifeoid that should make her life a little bit easier =u=
+
+## installing
+you'll need to make sure you have [the requirements for pygobject](https://pygobject.readthedocs.io/en/latest/getting_started.html) installed before you can `pip install`.
+```
+git clone https://git.bune.city/lynnesbian/buypeeb/
+cd buypeeb
+virtualenv venv
+source venv/bin/activate
+pip install -r requirements.txt
+```
+
+## running
+```
+source venv/bin/activate
+./buypeeb.py
+```