From ac0506e15bf2b638224327c3da94749c70ebd10b Mon Sep 17 00:00:00 2001
From: Simon Willison <swillison@gmail.com>
Date: Tue, 3 Jun 2025 15:52:09 -0700
Subject: [PATCH] AGENTS.md file for Codex

---
 AGENTS.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..cb8848e
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,30 @@
+# Repository maintenance notes
+
+This project uses a Python virtual environment for development and tests.
+
+## Setting up a development environment
+
+1. Create and activate a virtual environment:
+
+   ```bash
+   python -m venv venv
+   source venv/bin/activate
+   ```
+2. Install the project with its test dependencies:
+   ```bash
+   pip install -e '.[test]'
+   ```
+3. Run the tests:
+   ```bash
+   pytest
+   ```
+
+## Building the documentation
+
+Run the following commands if you want to build the docs locally:
+
+```bash
+cd docs
+pip install -r requirements.txt
+make html
+```