hermes - 💡(How to fix) Fix v0.15.0 PyPI release breaks ALL platforms — plugin.yaml manifests missing from package

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…

hermes-agent==0.15.0 (2026.5.28) installed cleanly from PyPI with the [messaging,mcp,cron,cli,slack,anthropic,acp] extras, but no platform adapters load:

WARNING gateway.run: No adapter available for discord
WARNING gateway.run: No adapter could be created for any of the 1 configured platform(s)

Same warning for Slack, Mattermost, etc. — affects all configured platforms.

Root Cause

Root cause (per HERMES_PLUGINS_DEBUG=1)

Fix Action

Fix / Workaround

I'm holding on v0.14.0 with local Ollama fallback (which catches the #33237 NoneType) until v0.15.1 lands. Happy to test as soon as a patch is published.

Code Example

WARNING gateway.run: No adapter available for discord
WARNING gateway.run: No adapter could be created for any of the 1 configured platform(s)

---

[plugins] DEBUG Scanning bundled plugins: /.../site-packages/plugins
[plugins] DEBUG   bundled (top-level): 0 manifest(s)
[plugins] DEBUG   bundled/platforms: 0 manifest(s)

---

$ find /.../site-packages/plugins -name plugin.yaml
(no matches)
RAW_BUFFERClick to expand / collapse

Summary

hermes-agent==0.15.0 (2026.5.28) installed cleanly from PyPI with the [messaging,mcp,cron,cli,slack,anthropic,acp] extras, but no platform adapters load:

WARNING gateway.run: No adapter available for discord
WARNING gateway.run: No adapter could be created for any of the 1 configured platform(s)

Same warning for Slack, Mattermost, etc. — affects all configured platforms.

Root cause (per HERMES_PLUGINS_DEBUG=1)

[plugins] DEBUG Scanning bundled plugins: /.../site-packages/plugins
[plugins] DEBUG   bundled (top-level): 0 manifest(s)
[plugins] DEBUG   bundled/platforms: 0 manifest(s)

Zero plugin.yaml manifests exist anywhere in the installed package. Verified:

$ find /.../site-packages/plugins -name plugin.yaml
(no matches)

But plugins/platforms/discord/__init__.py exists with the new register() entry point pointing at adapter.py. The Python module is shippable; the manifest the new plugin manager requires is not in the package.

Environment

  • macOS Sequoia / arm64 (M4 Pro)
  • Hermes Agent v0.15.0 (2026.5.28) from PyPI via uv tool install
  • Python 3.14.5
  • 13 Hermes profiles previously running cleanly on v0.14.0

Rolled back

uv tool install hermes-agent==0.14.0 — Discord adapter loads fine again, fleet operational (but still hitting #33237 NoneType, which is why we tried to upgrade).

Suggested fix

Looks like pyproject.toml / MANIFEST.in isn't including the platform plugin.yaml files in the sdist/wheel. The platform adapters' source code is bundled but their manifest files weren't.

I'm holding on v0.14.0 with local Ollama fallback (which catches the #33237 NoneType) until v0.15.1 lands. Happy to test as soon as a patch is published.

Cross-ref: #33237 (the NoneType fix that v0.15 was supposed to deliver).

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