Update pyproject.toml Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> (#39) (#47) (#72) (#73) (#74)

LICENSE

@@ -3,7 +3,7 @@
 
  Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
+ of this license document, but changing it is not allowed. 
 
                             Preamble
 

README.md

@@ -90,6 +90,21 @@ cd AGENTS.md
 ./scripts/start.sh
 ```
 
+---
+### ☁️ Vercel Deployment
+
+This repository includes a Vercel serverless entrypoint and routing config, so the FastAPI dashboard is served at `/` instead of returning `404: NOT_FOUND`.
+
+```bash
+# From the project root
+vercel
+```
+
+Vercel uses:
+- `vercel.json` to route every request to the Python serverless function.
+- `api/index.py` as the FastAPI entrypoint.
+- `requirements.txt` to install runtime dependencies.
+
 ---
 
 ## 🔌 API Examples

api/index.py

@@ -0,0 +1,14 @@
+"""Vercel serverless entrypoint for the FastAPI application."""
+
+from __future__ import annotations
+
+import sys
+from importlib import import_module
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+APP_DIR = ROOT / "app"
+if str(APP_DIR) not in sys.path:
+    sys.path.insert(0, str(APP_DIR))
+
+app = import_module("universal_compiler_agent.server").app

app/universal_compiler_agent/templates.py

@@ -150,6 +150,7 @@
   planButton.addEventListener('click', () => submit('/plan', planButton));
   compileButton.addEventListener('click', () => submit('/compile', compileButton));
 </script>
+<script defer src="https://cdn.vercel-insights.com/v1/script.js"></script>
 </body>
 </html>
 """

pyproject.toml

@@ -21,6 +21,7 @@ dev = [
   "pytest>=8.0,<9.0",
   "ruff>=0.6,<1.0",
   "httpx>=0.28,<1.0",
+  "httpx2>=0.28,<1.0",
   "codespell[toml]>=2.3,<3.0"
 ]
 

requirements.txt

@@ -0,0 +1,3 @@
+fastapi>=0.115,<1.0
+uvicorn[standard]>=0.30,<1.0
+pydantic>=2.8,<3.0

tests/test_vercel.py

@@ -0,0 +1,25 @@
+import importlib.util
+import json
+from pathlib import Path
+
+from fastapi.testclient import TestClient
+
+
+def test_vercel_routes_all_paths_to_fastapi_entrypoint() -> None:
+    config = json.loads(Path("vercel.json").read_text(encoding="utf-8"))
+
+    assert config["builds"] == [{"src": "api/index.py", "use": "@vercel/python"}]
+    assert config["routes"] == [{"src": "/(.*)", "dest": "api/index.py"}]
+
+
+def test_vercel_entrypoint_exposes_fastapi_app() -> None:
+    spec = importlib.util.spec_from_file_location("vercel_entrypoint", "api/index.py")
+    assert spec is not None
+    assert spec.loader is not None
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+
+    response = TestClient(module.app).get("/")
+
+    assert response.status_code == 200
+    assert "Universal Project Compiler Agent" in response.text

vercel.json

@@ -0,0 +1,14 @@
+{
+  "builds": [
+    {
+      "src": "api/index.py",
+      "use": "@vercel/python"
+    }
+  ],
+  "routes": [
+    {
+      "src": "/(.*)",
+      "dest": "api/index.py"
+    }
+  ]
+}