diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8ff9052
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# Kalshi 15m Crypto Probability Bot
+
+Strategy:
+- Every loop, discover the nearest-close open 15-minute "Up or Down" market for BTC/ETH/SOL
+- At T - 6 minutes (configurable), if YES ask or NO ask is between 70% and 95%, place a bet
+- Stake tiers:
+  - 70–80% => $1
+  - 80–90% => $2
+  - 90–95% => $2 (change in config.yaml)
+
+## Setup (Mac / Linux)
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+cp .env.example .env
+# edit .env with your key id + private key path
+source .env
+python bot.py