Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Bug]: `hermes update` Corrupts Git Repo and Breaks Installation [1 pull requests]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

1. Running hermes after failed update

root@ca81f755194a:~# hermes Traceback (most recent call last): File "/usr/local/lib/hermes-agent/venv/bin/hermes", line 4, in <module> from hermes_cli.main import main ModuleNotFoundError: No module named 'hermes_cli'

2. Attempting to recover via install.sh

root@ca81f755194a:~# bash install.sh

┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Installer │ ├─────────────────────────────────────────────────────────┤ │ An open source AI agent by Nous Research. │ └─────────────────────────────────────────────────────────┘

✓ Detected: linux (ubuntu) → Root install on Linux — using FHS layout → Code: /usr/local/lib/hermes-agent → Command: /usr/local/bin/hermes → Data: /root/.hermes (unchanged) → Checking for uv package manager... ✓ uv found (uv 0.11.15 (x86_64-unknown-linux-gnu)) → Checking Python 3.11... ✓ Python found: Python 3.11.15 → Checking Git... ✓ Git 2.53.0 found → Checking Node.js (for browser tools)... ✓ Node.js v26.2.0 found → Checking internet connectivity for package install and web tools... ✓ Internet connectivity looks good → Checking ripgrep (fast file search)... ✓ ripgrep 15.1.0 found → Checking ffmpeg (TTS voice messages)... ✓ ffmpeg 8.0.1-3ubuntu2 found → Installing to /usr/local/lib/hermes-agent... → Existing installation found, updating... remote: Enumerating objects: 3136, done. remote: Counting objects: 100% (1925/1925), done. remote: Compressing objects: 100% (187/187), done. remote: Total 3136 (delta 1808), reused 1741 (delta 1737), pack-reused 1211 (from 3) Receiving objects: 100% (3136/3136), 4.94 MiB | 2.63 MiB/s, done. Resolving deltas: 100% (2000/2000), completed with 867 local objects. fatal: bad object refs/remotes/origin/bb/tui-ctrlj-newline error: https://github.com/NousResearch/hermes-agent.git did not send all necessary objects

Root Cause

  1. hermes update: Fails during the Git pull/fetch process.
  2. hermes command: Crashes immediately with a Python import error because the environment was left in a broken state.
  3. install.sh: Unable to repair the installation because the local Git repository has a corrupted object reference.

Fix Action

Fixed

Code Example

# 1. Running hermes after failed update
root@ca81f755194a:~# hermes
Traceback (most recent call last):
  File "/usr/local/lib/hermes-agent/venv/bin/hermes", line 4, in <module>
    from hermes_cli.main import main
ModuleNotFoundError: No module named 'hermes_cli'

# 2. Attempting to recover via install.sh
root@ca81f755194a:~# bash install.sh


┌─────────────────────────────────────────────────────────┐
│             ⚕ Hermes Agent Installer                    │
├─────────────────────────────────────────────────────────┤
│  An open source AI agent by Nous Research.              │
└─────────────────────────────────────────────────────────┘

✓ Detected: linux (ubuntu)
→ Root install on Linux — using FHS layout
→   Code:    /usr/local/lib/hermes-agent
→   Command: /usr/local/bin/hermes
→   Data:    /root/.hermes (unchanged)
→ Checking for uv package manager...
✓ uv found (uv 0.11.15 (x86_64-unknown-linux-gnu))
→ Checking Python 3.11...
✓ Python found: Python 3.11.15
→ Checking Git...
✓ Git 2.53.0 found
→ Checking Node.js (for browser tools)...
✓ Node.js v26.2.0 found
→ Checking internet connectivity for package install and web tools...
✓ Internet connectivity looks good
→ Checking ripgrep (fast file search)...
✓ ripgrep 15.1.0 found
→ Checking ffmpeg (TTS voice messages)...
✓ ffmpeg 8.0.1-3ubuntu2 found
→ Installing to /usr/local/lib/hermes-agent...
→ Existing installation found, updating...
remote: Enumerating objects: 3136, done.
remote: Counting objects: 100% (1925/1925), done.
remote: Compressing objects: 100% (187/187), done.
remote: Total 3136 (delta 1808), reused 1741 (delta 1737), pack-reused 1211 (from 3)
Receiving objects: 100% (3136/3136), 4.94 MiB | 2.63 MiB/s, done.
Resolving deltas: 100% (2000/2000), completed with 867 local objects.
fatal: bad object refs/remotes/origin/bb/tui-ctrlj-newline
error: https://github.com/NousResearch/hermes-agent.git did not send all necessary objects

---
RAW_BUFFERClick to expand / collapse

Bug Description

I encountered a critical issue where running hermes update corrupted the local Git repository. This caused the subsequent hermes command to fail with a missing module error, and attempting to recover by running install.sh also failed due to the corrupted Git state.

Steps to Reproduce

  1. Start with a previously working installation of Hermes Agent.
  2. Run the update command: hermes update.
  3. The update process fails (Git error).
  4. Attempt to run the agent again using hermes -> Result: ModuleNotFoundError: No module named 'hermes_cli'.
  5. Attempt to fix by re-running the installer script bash install.sh -> Result: Git fatal error (bad object).

Expected Behavior

The hermes update command should safely update the repository and dependencies without corrupting the local Git state or breaking the existing installation.

Actual Behavior

  1. hermes update: Fails during the Git pull/fetch process.
  2. hermes command: Crashes immediately with a Python import error because the environment was left in a broken state.
  3. install.sh: Unable to repair the installation because the local Git repository has a corrupted object reference.

Affected Component

Setup / Installation

Messaging Platform (if gateway-related)

No response

Debug Report

# 1. Running hermes after failed update
root@ca81f755194a:~# hermes
Traceback (most recent call last):
  File "/usr/local/lib/hermes-agent/venv/bin/hermes", line 4, in <module>
    from hermes_cli.main import main
ModuleNotFoundError: No module named 'hermes_cli'

# 2. Attempting to recover via install.sh
root@ca81f755194a:~# bash install.sh


┌─────────────────────────────────────────────────────────┐
│             ⚕ Hermes Agent Installer                    │
├─────────────────────────────────────────────────────────┤
│  An open source AI agent by Nous Research.              │
└─────────────────────────────────────────────────────────┘

✓ Detected: linux (ubuntu)
→ Root install on Linux — using FHS layout
→   Code:    /usr/local/lib/hermes-agent
→   Command: /usr/local/bin/hermes
→   Data:    /root/.hermes (unchanged)
→ Checking for uv package manager...
✓ uv found (uv 0.11.15 (x86_64-unknown-linux-gnu))
→ Checking Python 3.11...
✓ Python found: Python 3.11.15
→ Checking Git...
✓ Git 2.53.0 found
→ Checking Node.js (for browser tools)...
✓ Node.js v26.2.0 found
→ Checking internet connectivity for package install and web tools...
✓ Internet connectivity looks good
→ Checking ripgrep (fast file search)...
✓ ripgrep 15.1.0 found
→ Checking ffmpeg (TTS voice messages)...
✓ ffmpeg 8.0.1-3ubuntu2 found
→ Installing to /usr/local/lib/hermes-agent...
→ Existing installation found, updating...
remote: Enumerating objects: 3136, done.
remote: Counting objects: 100% (1925/1925), done.
remote: Compressing objects: 100% (187/187), done.
remote: Total 3136 (delta 1808), reused 1741 (delta 1737), pack-reused 1211 (from 3)
Receiving objects: 100% (3136/3136), 4.94 MiB | 2.63 MiB/s, done.
Resolving deltas: 100% (2000/2000), completed with 867 local objects.
fatal: bad object refs/remotes/origin/bb/tui-ctrlj-newline
error: https://github.com/NousResearch/hermes-agent.git did not send all necessary objects

Operating System

Ubuntu 26.04 LTS

Python Version

3.11.15

Hermes Version

No response

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

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

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix [Bug]: `hermes update` Corrupts Git Repo and Breaks Installation [1 pull requests]