How to fix: Hermes requires Python 3.11 or newer
Hermes needs Python 3.11+: check with python3 --version and upgrade via your package manager. The official installer handles Python 3.11 automatically, so this mostly hits self-managed environments.
Who this is for：People with self-managed Python environments or older systems.
Steps
-
Check the version
python3 --version -
Upgrade Python
Use your package manager to reach 3.11+ (apt on Ubuntu, brew on macOS).
-
Missing the uv package manager?
Install command from the official FAQ.
curl -LsSf https://astral.sh/uv/install.sh | sh -
Re-run the official installer
It handles Python 3.11 automatically and often repairs the environment.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
How to verify
- python3 --version shows 3.11+
- hermes doctor passes
FAQ
Why don't most installs hit this?
The official one-liner installs Python 3.11 automatically; version problems mostly affect self-managed setups.
Related pages
- Download and Install Hermes Agent on macOS
- Download and Install Hermes Agent on Windows (Desktop / PowerShell / WSL2)
- Download and Install Hermes Agent on Linux
- Install Hermes Agent on WSL2 (Advanced Windows Path)
- Hermes Agent Model Provider and API Key Setup
- Migrate from OpenClaw to Hermes Agent (official hermes claw migrate)
- How to fix: hermes: command not found
- How to fix: API key not set / invalid API key
- How to fix: context length exceeded
- Telegram + Hermes Agent: Known Pitfalls and Fixes
- Curated official issues
- School solution cards