fix(install): work on bare servers without PATH hermes or python3-venv
authorSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Sat, 18 Jul 2026 12:27:17 +0000 (15:27 +0300)
committerSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Sat, 18 Jul 2026 12:27:17 +0000 (15:27 +0300)
commitb18f3d80431a38a95783be54aedaea86c1599f90
tree8cc40a8b27ca73a289a3e2ecf59f92807334d00f
parent1528b7dd210904b085b54d56de4f963d6061fb52
fix(install): work on bare servers without PATH hermes or python3-venv

Found during first install on a fresh Debian 13 server:

- Installer now probes ~/.local/bin/hermes, ~/bin, /usr/local/bin and
  /usr/bin for the hermes CLI instead of relying on PATH alone.
  Non-login SSH shells never read ~/.profile, so "hermes CLI not found"
  fired and memory.provider was left unset.
- New shared Tools/lib/common.sh picks a working Python for all Tools
  scripts: project .venv (only if sqlite-vec + model2vec actually
  import — a failed python3 -m venv on hosts without the python3-venv
  apt package leaves a half-created venv that passes -x checks), then
  uv (bundled with Hermes at ~/.hermes/bin/uv), then the Hermes runtime
  venv. Broken half-venvs are recreated instead of trusted.
- Docs: prerequisites updated (no PATH / python3-venv needed), importer
  fallback and idempotency documented, systemd restart hint including
  the "Gateway already running (PID ...)" stale-lock case.
- AGENTS.org: Tools/lib layout entry and three new pitfalls.
AGENTS.org
Documentation/index.org
Install Retinue
Tools/Import Holographic memories
Tools/Run tests
Tools/Show Retinue memory contents
Tools/lib/common.sh [new file with mode: 0644]