From e82479cd8cd84ec9e853821624bb08ce921ecf32 Mon Sep 17 00:00:00 2001
From: Jamie Chicago <87397251+jamiechicago312@users.noreply.github.com>
Date: Thu, 21 May 2026 12:48:10 -0500
Subject: [PATCH] docs: add Windows workaround for Bad Gateway on npm run dev

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 6a7308832..3fb8ce5db 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,12 @@ npm install
 npm run dev
 ```
 
+> **Windows:** `npm run dev` may show a Bad Gateway error if Vite exits with a `C:\Program` path error. Run the dev stack directly instead:
+> ```powershell
+> $env:PYTHONUTF8 = "1"
+> node --env-file-if-exists=.env .\scripts\dev-with-automation.mjs
+> ```
+
 Access the UI at [http://localhost:8000](http://localhost:8000). You can add additional backends directly from the UI.
 
 # Architecture