hermes version Command — Complete Reference & Examples

Overview

hermes version prints the currently installed Hermes Agent version along with installation details: the install directory, install method, Python version, and OpenAI SDK version. It takes no options besides -h/--help.

hermes version

What It Shows

• Version — semantic version and build date
• Upstream — upstream commit the build is based on
• Install directory — where Hermes is installed
• Install method — how Hermes was installed (git, pip, binary, …)
• Python version — the Python runtime in use
• OpenAI SDK — the bundled OpenAI SDK version
• Update availability — how many commits behind you are and the command to update

Example output:

Hermes Agent v0.20.0 (2026.8.3) · upstream 52a5fc00
Install directory: /Users/neo/.hermes/hermes-agent
Install method: git
Python: 3.11.15
OpenAI SDK: 2.24.0
Update available: 195 commits behind — run 'hermes update'

Common Scenarios

Confirming Installation

hermes version
# Verify Hermes is installed and which version you are running

Checking for Updates

hermes version
# The output tells you if an update is available and how far behind you are

Bug Report Preparation

hermes version
# Include this output in your bug report
# Pair with hermes dump for a full setup summary

Verifying After Upgrade

hermes update
hermes version
# Confirm the new version is active

Tips

• The command has no options besides -h/--help
• Always include hermes version output when filing issues
• The upstream commit helps maintainers identify the exact code revision
• The update notice tells you how many commits behind you are — run hermes update when it appears