Skip to content

docs: Windows notes for backend launch and system-proxy NO_PROXY - #202

Merged
luckeyfaraday merged 1 commit into
mainfrom
docs/windows-backend-launch-notes
Aug 7, 2026
Merged

luckeyfaraday merged 1 commit into
mainfrom
docs/windows-backend-launch-notes

Conversation

@luckeyfaraday

Copy link
Copy Markdown
Owner

Two Windows deployment traps for the headless backend + Hermes MCP bridge:

  1. Launch: the backend must be started as a module from the repo root — python -m backend.launcher. Running the file by path fails with ModuleNotFoundError: No module named 'backend'.
  2. System proxy: with Clash/v2rayN enabled, httpx in the MCP bridge honors the Windows system proxy and routes localhost through it → 502 Bad Gateway while the backend is healthy. NO_PROXY=127.0.0.1,localhost in the bridge env fixes it.

Docs-only change covering both items.

Closes #197
Closes #198

@luckeyfaraday
luckeyfaraday merged commit 9eb3511 into main Aug 7, 2026
1 check passed
@luckeyfaraday
luckeyfaraday deleted the docs/windows-backend-launch-notes branch August 7, 2026 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant