Issue Station
Sign In
Tools hereToolbox

hermes - ✅(Solved) Fix [Bug]: fresh hermes install leads to hermes acp dependency incompatibility [1 pull requests, 3 comments, 2 participants]

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…
GitHub stats
NousResearch/hermes-agent#24959•Fetched 2026-05-14 03:50:19
View on GitHub
Comments
3
Participants
2
Timeline
7
Reactions
0
Author
yevheniipopravkayevheniipopravka
Participants
konsisumerkonsisumeryevheniipopravkayevheniipopravka
Timeline (top)
commented ×3labeled ×3cross-referenced ×1

Error Message

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. marker-pdf 1.10.1 requires openai<2.0.0,>=1.65.2, but you have openai 2.24.0 which is incompatible.

Root Cause

Root Cause Analysis (optional)

Fix Action

Fixed

PR fix notes

PR #24992: fix(cli): show actual missing module when hermes acp ImportError isn't acp

Description (problem / solution / changelog)

Stop reporting unrelated ImportErrors during hermes acp startup as "ACP dependencies not installed".

What changed and why

  • hermes acp (hermes_cli/main.py:cmd_acp) used to catch every ImportError raised while loading the adapter and print ACP dependencies not installed. Install them with: pip install -e '.[acp]'. The adapter imports acp (the agent-client-protocol Python package) lazily inside acp_adapter.entry.main, so any unrelated ImportError raised after the env / logging setup runs is reported as an [acp] extra problem — sending users in circles reinstalling an extra that isn't the cause.
  • New module-level helper _format_acp_import_error inspects ImportError.name. If the missing module is acp or starts with acp., it keeps the existing "install the extra" message (which is the real diagnosis in that case). For any other missing module it surfaces the actual failing import and clarifies that this is not an [acp] packaging issue, so users can investigate the real install corruption instead.
  • This is what surfaces in #24959: pip warned about a pre-installed marker-pdf clashing with the project's openai==2.24.0 pin (a soft post-install warning, not a fatal error), and then hermes acp reported "ACP dependencies not installed" — making it look like the install actually failed. With this change, if the underlying problem is e.g. a different broken transitive, the user sees what it is rather than reinstalling the [acp] extra over and over.

How to test

  • pytest tests/hermes_cli/test_acp_import_error.py -v exercises all four branches: missing acp, missing acp.<sub>, missing unrelated module, and ImportError without a name attribute.
  • pytest tests/acp tests/acp_adapter still green (226 tests).
  • ruff check . clean.

What platforms tested on

  • macOS on darwin-arm64 (local) — ruff check, the new test, and the existing acp/acp_adapter suites.
  • The reporter is on Windows 11; the helper is pure-Python string formatting with no platform-specific paths, so behavior is identical there.

Fixes #24959

<!-- autocontrib:worker-id=issue-new-c3b31805 kind=pr-open -->

Changed files

  • hermes_cli/main.py (modified, +29/-3)
  • tests/hermes_cli/test_acp_import_error.py (added, +40/-0)

Code Example

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
marker-pdf 1.10.1 requires openai<2.0.0,>=1.65.2, but you have openai 2.24.0 which is incompatible.

---

> hermes acp
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Loaded env from C:\Users\Popravka\AppData\Local\hermes\.env
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Starting hermes-agent ACP adapter
ACP dependencies not installed.
Install them with:  pip install -e '.[acp]'

---

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
marker-pdf 1.10.1 requires openai<2.0.0,>=1.65.2, but you have openai 2.24.0 which is incompatible.

---

> hermes acp
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Loaded env from C:\Users\Popravka\AppData\Local\hermes\.env
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Starting hermes-agent ACP adapter
ACP dependencies not installed.
Install them with:  pip install -e '.[acp]'

---

https://paste.rs/7LwAE
https://paste.rs/3z7Ms

---
RAW_BUFFERClick to expand / collapse

Bug Description

I need hermes acp to use vscode extention, tried to install dependencies running pip install -e '.[acp]' produces:

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
marker-pdf 1.10.1 requires openai<2.0.0,>=1.65.2, but you have openai 2.24.0 which is incompatible.

running hermes acp results in

> hermes acp
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Loaded env from C:\Users\Popravka\AppData\Local\hermes\.env
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Starting hermes-agent ACP adapter
ACP dependencies not installed.
Install them with:  pip install -e '.[acp]'

Steps to Reproduce

running pip install -e '.[acp]' produces:

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
marker-pdf 1.10.1 requires openai<2.0.0,>=1.65.2, but you have openai 2.24.0 which is incompatible.

running hermes acp results in

> hermes acp
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Loaded env from C:\Users\Popravka\AppData\Local\hermes\.env
2026-05-13 13:53:53 [INFO] acp_adapter.entry: Starting hermes-agent ACP adapter
ACP dependencies not installed.
Install them with:  pip install -e '.[acp]'

Expected Behavior

hermes acp dependency install succeeds and acp runs

Actual Behavior

hermes acp not starting

Affected Component

Other

Messaging Platform (if gateway-related)

No response

Debug Report

https://paste.rs/7LwAE
https://paste.rs/3z7Ms

Operating System

windows 11

Python Version

No response

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…
#dependency conflict#index setup#retrieval issue#search optimization#API routing

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 - ✅(Solved) Fix [Bug]: fresh hermes install leads to hermes acp dependency incompatibility [1 pull requests, 3 comments, 2 participants]