hermes - 💡(How to fix) Fix [Bug]: Root-mode Installation error with uv python path

Bug Description

When trying to install as root (https://hermes-agent.nousresearch.com/docs/getting-started/installation), the installer sets venv Python to root's uv-managed Python at /root/.local/share/uv/python, so normal users could not run the shared /usr/local/bin/hermes command.

Steps to Reproduce

1. Run installer script as sudo curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-setup
2. As non-root user, run hermes hermes

Expected Behavior

Should start Hermes CLI

Actual Behavior

<user>@<machine>:~$ hermes /usr/local/bin/hermes: /usr/local/lib/hermes-agent/venv/bin/hermes: /usr/local/lib/hermes-agent/venv/bin/python3: bad interpreter: Permission denied /usr/local/bin/hermes: line 4: /usr/local/lib/hermes-agent/venv/bin/hermes: Success

Affected Component

Setup / Installation

Messaging Platform (if gateway-related)

No response

Debug Report

⚠️  This will upload the following to a public paste service:
  • System info (OS, Python version, Hermes version, provider, which API keys
    are configured — NOT the actual keys)
  • Recent log lines (agent.log, errors.log, gateway.log — may contain
    conversation fragments and file paths)
  • Full agent.log and gateway.log (up to 512 KB each — likely contains
    conversation content, tool outputs, and file paths)

Pastes auto-delete after 6 hours.

Collecting debug report...
Uploading...

Debug report uploaded:
  Report  https://paste.rs/znG6v

⏱  Pastes will auto-delete in 6 hours.
To delete now:  hermes debug delete <url>

Share these links with the Hermes team for support.

Operating System

Ubuntu 24.04.4 LTS

Python Version

Python 3.12.3

Hermes Version

Hermes Agent v0.13.0 (2026.5.7)

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

Manually injecting env vars fixes the install. Installer script needs to detect user=root and handle the vars differently for system install, rather than using the normal pattern of ~/<path> curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh |
sudo env
UV_PYTHON_INSTALL_DIR=/usr/local/share/uv/python
UV_PYTHON_BIN_DIR=/usr/local/share/uv/bin
bash -s -- --skip-setup

Proposed Fix (optional)

Are you willing to submit a PR for this?

• I'd like to fix this myself and submit a PR