Skip to content

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

Open
TunaTung wants to merge 1 commit into
luckeyfaraday:mainfrom
TunaTung:main
Open

docs: Windows notes for direct backend launch and system-proxy NO_PROXY#199
TunaTung wants to merge 1 commit into
luckeyfaraday:mainfrom
TunaTung:main

Conversation

@TunaTung

@TunaTung TunaTung commented Aug 1, 2026

Copy link
Copy Markdown

Closes #197 and #198.

Two Windows-specific traps discovered while deploying the headless backend + Hermes MCP bridge on Windows 11:

  1. Launch: python backend/launcher.py fails with ModuleNotFoundError: No module named 'backend' — must run python -m backend.launcher from the repo root.
  2. System proxy: with Clash/v2rayN enabled, httpx inside the MCP bridge honors the Windows system proxy and routes localhost through it → 502 Bad Gateway. Setting NO_PROXY=127.0.0.1,localhost in the bridge env fixes it.

Docs-only change; both items verified on Windows 11.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Windows] backend/launcher.py fails with ModuleNotFoundError when run directly; needs python -m backend.launcher

1 participant