diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..c1fb3ea358
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+## Setup
+```
+pip install -r requirements.txt
+git clone git@github.com:NousResearch/hecate.git
+cd hecate
+pip install -e .
+```
+
+## Run
+```
+python run_agent.py \
+  --query "search up the latest docs on the new openai responses api and write me a hello world example that's not in their docs. run it to verify. search up public github examples if needbe" \
+  --max_turns 20 \
+  --model claude-sonnet-4-20250514 \
+  --base_url https://api.anthropic.com/v1/ \
+  --api_key $ANTHROPIC_API_KEY
+```