Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix Dashboard fails to start on v0.15.2: ModuleNotFoundError: No module named 'hermes_cli.dashboard_auth'

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

Traceback (most recent call last): File "/usr/local/bin/hermes", line 8, in <module> sys.exit(main()) ^^^^^^ File "/usr/local/lib/python3.12/dist-packages/hermes_cli/main.py", line 14303, in main args.func(args) File "/usr/local/lib/python3.12/dist-packages/hermes_cli/main.py", line 10937, in cmd_dashboard from hermes_cli.web_server import start_server File "/usr/local/lib/python3.12/dist-packages/hermes_cli/web_server.py", line 4822, in <module> from hermes_cli.dashboard_auth.routes import router as _dashboard_auth_router # noqa: E402 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ModuleNotFoundError: No module named 'hermes_cli.dashboard_auth'

Root Cause

The hermes_cli.dashboard_auth module is referenced in web_server.py but not included in the v0.15.2 package on PyPI.

Fix Action

Workaround

Rollback to v0.14.0:

pip install --force-reinstall hermes-agent==0.14.0

Code Example

pip install hermes-agent==0.15.2

---

hermes dashboard --port 9119 --host 127.0.0.1

---

Traceback (most recent call last):
  File "/usr/local/bin/hermes", line 8, in <module>
    sys.exit(main())
             ^^^^^^
  File "/usr/local/lib/python3.12/dist-packages/hermes_cli/main.py", line 14303, in main
    args.func(args)
  File "/usr/local/lib/python3.12/dist-packages/hermes_cli/main.py", line 10937, in cmd_dashboard
    from hermes_cli.web_server import start_server
  File "/usr/local/lib/python3.12/dist-packages/hermes_cli/web_server.py", line 4822, in <module>
    from hermes_cli.dashboard_auth.routes import router as _dashboard_auth_router  # noqa: E402
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'hermes_cli.dashboard_auth'

---

pip install --force-reinstall hermes-agent==0.14.0
RAW_BUFFERClick to expand / collapse

Bug Description

Dashboard fails to start on v0.15.2 (and v0.15.1) due to missing hermes_cli.dashboard_auth module.

Environment

  • Hermes Version: 0.15.2 (also tested 0.15.1)
  • Python: 3.12.3
  • OS: Ubuntu/Debian ARM64
  • Installation method: pip install --break-system-packages hermes-agent==0.15.2

Steps to Reproduce

  1. Install Hermes v0.15.2 from PyPI:

    pip install hermes-agent==0.15.2

  2. Start dashboard:

    hermes dashboard --port 9119 --host 127.0.0.1

Expected Behavior

Dashboard should start successfully on port 9119.

Actual Behavior

Dashboard crashes immediately with:

Traceback (most recent call last):
  File "/usr/local/bin/hermes", line 8, in <module>
    sys.exit(main())
             ^^^^^^
  File "/usr/local/lib/python3.12/dist-packages/hermes_cli/main.py", line 14303, in main
    args.func(args)
  File "/usr/local/lib/python3.12/dist-packages/hermes_cli/main.py", line 10937, in cmd_dashboard
    from hermes_cli.web_server import start_server
  File "/usr/local/lib/python3.12/dist-packages/hermes_cli/web_server.py", line 4822, in <module>
    from hermes_cli.dashboard_auth.routes import router as _dashboard_auth_router  # noqa: E402
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'hermes_cli.dashboard_auth'

Root Cause

The hermes_cli.dashboard_auth module is referenced in web_server.py but not included in the v0.15.2 package on PyPI.

Workaround

Rollback to v0.14.0:

pip install --force-reinstall hermes-agent==0.14.0

Impact

  • Severity: High — dashboard completely unusable on v0.15.1 and v0.15.2
  • Affected versions: 0.15.1, 0.15.2 (0.14.0 works fine)
  • Users cannot upgrade to benefit from v0.15.x improvements (Kanban, performance fixes)

Additional Context

  • Reinstalling with --force-reinstall --no-cache-dir does not fix the issue
  • The changelog mentions dashboard fixes (infinite-reload loop) but no mention of packaging issues
  • This appears to be a packaging/build problem rather than code issue

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