diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ef87dbd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# Kowalski is a bot
+
+Quick start:
+
+```cp envrc.example .envrc```
+
+```uv run kowalski.py```