diff --git a/.agents/environment.yaml b/.agents/environment.yaml
new file mode 100644
index 000000000..afd602964
--- /dev/null
+++ b/.agents/environment.yaml
@@ -0,0 +1,11 @@
+initialize: |
+  uv venv .venv
+  . .venv/bin/activate
+  uv pip install pre-commit setuptools wheel
+  uv pip install -r internal/requirements.txt
+  uv pip install modal
+  pre-commit install
+maintenance: |
+  . .venv/bin/activate
+  uv pip install -r internal/requirements.txt
+  uv pip install modal