HERMES-GIELIE/docs
nesquena-hermes 11625aac1a fix(bootstrap): discover agent installed as root (FHS) or behind the bash launcher
A fresh root install on Linux (e.g. a new Proxmox/Ubuntu VM) places the Hermes
Agent at /usr/local/lib/hermes-agent and links the CLI into /usr/local/bin,
while the modern `hermes` launcher is a `#!/usr/bin/env bash` wrapper that
exec's the venv entrypoint. The old discovery only checked
~/.hermes/hermes-agent-style paths and parsed the launcher's shebang as a Python
interpreter, so on a root VM discover_agent_dir() returned None, bootstrap built
a WebUI-only .venv, and chat aborted at launch with "Python environment cannot
import both WebUI dependencies and Hermes Agent."

Two complementary fixes:
- Add /usr/local/lib/hermes-agent to discover_agent_dir()'s candidate list.
- Harden _agent_dir_from_hermes_cli() to follow the launcher's exec target (any
  absolute path quoted in the wrapper) up to run_agent.py, not just a Python
  shebang. Skips /usr/bin/env indirection.

Now `python3 bootstrap.py` works out of the box for root/container installs with
no HERMES_WEBUI_PYTHON override needed. Adds tests for the bash-wrapper shape,
the env-indirection no-false-positive case, and the FHS candidate probe; updates
docs/troubleshooting.md.
2026-06-21 16:55:40 +00:00
..
architecture rebase #4411 onto master (v0.51.542) for deep-review — Stable Assistant Turn Anchors capstone 2026-06-20 21:48:55 +00:00
images docs: add clarify dialog screenshot evidence 2026-05-25 16:25:11 +08:00
pr-assets
pr-media Release v0.51.238 — Release HF (stage-q9) (#3493) 2026-06-03 12:23:46 -07:00
rfcs fix(anchor): harden registry contract before wiring 2026-06-13 00:44:26 +08:00
ui-ux chore(#4024): drop docs/ui-ux/review-shots/ trifecta scratch from the release diff 2026-06-13 02:15:01 +00:00
advanced-chat-setup.md docs(readme): re-sequence IA — pull Features up, consolidate access, extract niche docs 2026-06-01 02:26:18 +00:00
CONTRACTS.md Release LW stage — v0.51.359 (#3962 assistant turn anchor phase 0 scaffold) (#3977) 2026-06-10 23:14:18 -07:00
docker.md stage #4491: multi-container gateway URL (#4483) + v0.51.517 CHANGELOG 2026-06-19 19:09:00 +00:00
EXTENSIONS.md stage #4588 — extensions settings diagnostics panel 2026-06-21 07:10:05 +00:00
ISSUES.md
onboarding-agent-checklist.md
onboarding.md docs(onboarding): place AIML setup with custom-provider guidance (#4045) 2026-06-12 12:41:43 -04:00
remote-access.md docs(readme): re-sequence IA — pull Features up, consolidate access, extract niche docs 2026-06-01 02:26:18 +00:00
supervisor.md fix: block duplicate webui start when launchd owns 8787 2026-05-31 23:02:23 +00:00
troubleshooting.md fix(bootstrap): discover agent installed as root (FHS) or behind the bash launcher 2026-06-21 16:55:40 +00:00
UIUX-GUIDE.md [HELD — independent review pending] Release v0.51.294 — stage-3401 (live-to-final redesign #3401 + 4 deep-review fixes) (#3741) 2026-06-06 12:12:37 -07:00
why-hermes.md
workspace-git.md Release v0.51.311 — Release KA (brick-wave: workspace Git RCE hardening #3769 + stale-snapshot sidebar visibility #3770) (#3776) 2026-06-07 08:05:30 -07:00
wsl-autostart.md