diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 00000000..2983e988
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,16 @@
+{
+    "name": "Open Deep Research Dev Container",
+    "image": "mcr.microsoft.com/devcontainers/python:3.11",
+    "features": {
+        "ghcr.io/devcontainers/features/git-lfs:1": {}
+    },
+    "postCreateCommand": "curl -LsSf https://astral.sh/uv/install.sh | sh && uv sync",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-python.python",
+                "ms-toolsai.jupyter"
+            ]
+        }
+    }
+}
\ No newline at end of file
diff --git a/README.md b/README.md
index 5bfa38ac..4f8bbbae 100644
--- a/README.md
+++ b/README.md
@@ -132,6 +132,10 @@ You can also deploy your own instance of OAP, and make your own custom agents (l
 1. [Deploy Open Agent Platform](https://docs.oap.langchain.com/quickstart)
 2. [Add Deep Researcher to OAP](https://docs.oap.langchain.com/setup/agents)
 
+#### Dev Container
+
+This repo includes a [Dev Container](https://containers.dev/) setup so you can run it instantly in the browser with [GitHub Codespaces](https://github.com/features/codespaces), or locally in VS Code with the Dev Containers extension. This ensures a consistent environment with all dependencies pre-installed.
+
 ### Legacy Implementations 🏛️
 
 The `src/legacy/` folder contains two earlier implementations that provide alternative approaches to automated research. They are less performant than the current implementation, but provide alternative ideas understanding the different approaches to deep research.