Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix Bug: Homebrew package exposes hermes proxy but misses hermes_cli.proxy

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…

The hermes proxy command is exposed in the Homebrew-installed CLI, but the packaged distribution appears to be missing the hermes_cli.proxy subpackage. As a result, the advertised proxy subcommands fail immediately with ModuleNotFoundError.

Error Message

$ hermes proxy providers Traceback (most recent call last): File "/opt/homebrew/bin/hermes", line 6, in <module> sys.exit(main()) ~~~~^^ File "/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/main.py", line 12402, in main args.func(args) ~~~~~~~~~^^^^^^ File "/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/main.py", line 1480, in cmd_proxy from hermes_cli.proxy.cli import cmd_proxy as _cmd_proxy ModuleNotFoundError: No module named 'hermes_cli.proxy'

Root Cause

The hermes proxy command is exposed in the Homebrew-installed CLI, but the packaged distribution appears to be missing the hermes_cli.proxy subpackage. As a result, the advertised proxy subcommands fail immediately with ModuleNotFoundError.

Code Example

Hermes Agent v0.14.0 (2026.5.16)
Install: Homebrew
Project: /opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages
Python: 3.14.5
OpenAI SDK: 2.36.0

---

hermes proxy --help
hermes proxy providers
hermes proxy status

---

usage: hermes proxy [-h] {start,status,providers} ...

Run a local HTTP server that forwards OpenAI-compatible requests to an OAuth-
authenticated provider (e.g. Nous Portal). External apps can point at the
proxy with any bearer token; the proxy attaches your real credentials.

---

$ hermes proxy providers
Traceback (most recent call last):
  File "/opt/homebrew/bin/hermes", line 6, in <module>
    sys.exit(main())
             ~~~~^^
  File "/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/main.py", line 12402, in main
    args.func(args)
    ~~~~~~~~~^^^^^^
  File "/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/main.py", line 1480, in cmd_proxy
    from hermes_cli.proxy.cli import cmd_proxy as _cmd_proxy
ModuleNotFoundError: No module named 'hermes_cli.proxy'

---

hermes proxy status

---

/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/proxy/  # missing

---

from pathlib import Path
base = Path('/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli')
print(base.exists())          # True
print((base / 'proxy').exists())  # False

---

hermes_cli/proxy/__init__.py
hermes_cli/proxy/cli.py
hermes_cli/proxy/server.py
hermes_cli/proxy/adapters/
RAW_BUFFERClick to expand / collapse

Summary

The hermes proxy command is exposed in the Homebrew-installed CLI, but the packaged distribution appears to be missing the hermes_cli.proxy subpackage. As a result, the advertised proxy subcommands fail immediately with ModuleNotFoundError.

Environment

Hermes Agent v0.14.0 (2026.5.16)
Install: Homebrew
Project: /opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages
Python: 3.14.5
OpenAI SDK: 2.36.0

Reproduction

hermes proxy --help
hermes proxy providers
hermes proxy status

hermes proxy --help works and advertises the feature:

usage: hermes proxy [-h] {start,status,providers} ...

Run a local HTTP server that forwards OpenAI-compatible requests to an OAuth-
authenticated provider (e.g. Nous Portal). External apps can point at the
proxy with any bearer token; the proxy attaches your real credentials.

But the subcommands fail:

$ hermes proxy providers
Traceback (most recent call last):
  File "/opt/homebrew/bin/hermes", line 6, in <module>
    sys.exit(main())
             ~~~~^^
  File "/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/main.py", line 12402, in main
    args.func(args)
    ~~~~~~~~~^^^^^^
  File "/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/main.py", line 1480, in cmd_proxy
    from hermes_cli.proxy.cli import cmd_proxy as _cmd_proxy
ModuleNotFoundError: No module named 'hermes_cli.proxy'

Same result for:

hermes proxy status

Packaging check

The installed Homebrew package has hermes_cli, but no proxy subdirectory:

/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli/proxy/  # missing

A quick local check:

from pathlib import Path
base = Path('/opt/homebrew/Cellar/hermes-agent/2026.5.16/libexec/lib/python3.14/site-packages/hermes_cli')
print(base.exists())          # True
print((base / 'proxy').exists())  # False

However, GitHub main currently contains:

hermes_cli/proxy/__init__.py
hermes_cli/proxy/cli.py
hermes_cli/proxy/server.py
hermes_cli/proxy/adapters/

Expected behavior

hermes proxy providers and hermes proxy status should either:

  1. work as advertised, or
  2. be hidden/disabled in this release if the proxy package is not included.

Actual behavior

The command is shown in hermes proxy --help, but running the subcommands crashes before any proxy logic executes.

Impact

This makes the new local OpenAI-compatible proxy unusable from the Homebrew distribution. The feature is especially useful for external OpenAI-compatible clients that should use Hermes-managed OAuth/provider credentials without copying raw provider secrets into each app.

Related PR found while checking: #25969 (feat(proxy): local OpenAI-compatible proxy for OAuth providers).

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…

FAQ

Expected behavior

hermes proxy providers and hermes proxy status should either:

  1. work as advertised, or
  2. be hidden/disabled in this release if the proxy package is not included.
#task chaining#parallel task#integration issue#index setup#retrieval issue

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: Homebrew package exposes hermes proxy but misses hermes_cli.proxy