Skip to content

Native Windows support (PowerShell installer)#39

Merged
0xadvait merged 1 commit into
mainfrom
windows-native
Jun 26, 2026
Merged

Native Windows support (PowerShell installer)#39
0xadvait merged 1 commit into
mainfrom
windows-native

Conversation

@0xadvait

Copy link
Copy Markdown
Collaborator

Hermes runs natively on Windows (uv-based clone at %LOCALAPPDATA%\hermes), so ghost can too.

The blocker I flagged -- the bash fork relocates the engine venv via path-rewriting, which can't work on Windows (Scripts\*.exe launchers bake the interpreter path into the binary) -- is solved by having the Windows fork recreate the venv with uv (uv venv + uv sync), exactly how Hermes builds it on Windows.

  • install.ps1 mirrors install.sh: self-bootstrap clone, uv, install Hermes if missing, fork+debrand, isolated privacy venv (uv sync of pyproject), Task Scheduler services for the scrubber + og-veil, ghost/ghost-login/ghost-update .cmd shims, PATH.
  • scripts/fork-engine.ps1: copy engine + recreate venv with uv + debrand.py + skills isolation + verify.
  • README: Windows one-liner + badge.

⚠️ Authored without a Windows machine. Both .ps1 files are PowerShell-parse-checked (no syntax errors), but the end-to-end install is unverified on real Windows -- it needs a Windows box to validate and almost certainly some debugging (venv recreate, Task Scheduler, paths). The macOS/Linux install.sh is untouched.

…vices)

Hermes runs natively on Windows (uv-based git clone at %LOCALAPPDATA%\hermes),
so ghost can too. The one blocker -- the bash fork relocates the engine venv by
rewriting paths, which can't work on Windows (Scripts\*.exe launchers bake the
interpreter path into the binary) -- is solved by having the Windows fork
RECREATE the venv with uv instead (uv venv + uv sync), the same way Hermes
builds it.

- install.ps1: PowerShell installer mirroring install.sh (self-bootstrap clone,
  uv, install Hermes if missing, fork+debrand, isolated privacy venv via uv sync,
  Task Scheduler services for scrubber + og-veil, ghost/.cmd command shims, PATH).
- scripts/fork-engine.ps1: copy engine + recreate venv with uv + debrand.py +
  skills isolation + verify.
- README: Windows PowerShell one-liner + platform badge.

NOTE: authored without a Windows machine -- both .ps1 files are PowerShell-parse-
checked but the install flow is UNVERIFIED on real Windows. Needs a Windows box
to validate and debug. macOS/Linux install.sh is untouched.
@0xadvait 0xadvait merged commit fb28fa4 into main Jun 26, 2026
@0xadvait 0xadvait deleted the windows-native branch June 26, 2026 14:51
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.

1 participant