hermes - 💡(How to fix) Fix [Bug]: Mautrix is not included in Nix 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…

Error Message

Additional Logs / Traceback (optional)

Root Cause

Root Cause Analysis (optional)

Fix Action

Fix / Workaround

2026-05-16 11:20:15,259 WARNING gateway.run: Shutdown context: signal=SIGTERM under_systemd=yes parent_pid=1 parent_name=systemd loadavg_1m=0.24 parent_cmdline='/run/current-system/systemd/lib/systemd/systemd --switched-root --system --deserialize=43'
2026-05-16 11:20:15,260 INFO gateway.run: Stopping gateway...
2026-05-16 11:20:15,260 INFO gateway.run: Shutdown phase: notify_active_sessions done at +0.00s
2026-05-16 11:20:15,262 INFO gateway.run: Shutdown phase: drain done at +0.00s (drain took 0.00s, timed_out=False, active_at_start=0, active_now=0)
2026-05-16 11:20:15,264 INFO gateway.platforms.webhook: [webhook] Disconnected
2026-05-16 11:20:15,264 INFO gateway.run: ✓ webhook disconnected (0.00s)
2026-05-16 11:20:15,264 INFO gateway.run: Shutdown phase: all adapters disconnected at +0.00s
2026-05-16 11:20:15,291 INFO gateway.run: Shutdown phase: final-cleanup tool kill done at +0.03s
2026-05-16 11:20:15,294 INFO gateway.run: Shutdown phase: SessionDB close done at +0.03s
2026-05-16 11:20:15,296 INFO gateway.run: Gateway stopped (total teardown 0.04s)
2026-05-16 11:20:15,296 INFO gateway.run: Cron ticker stopped
2026-05-16 11:20:16,430 INFO gateway.run: Starting Hermes Gateway...
2026-05-16 11:20:16,430 INFO gateway.run: Session storage: /home/sgiath/hermes/.hermes/sessions
2026-05-16 11:20:16,431 INFO gateway.run: Agent budget: max_iterations=150 (agent.max_turns from config.yaml, or HERMES_MAX_ITERATIONS from .env, or default 90)
2026-05-16 11:20:16,431 INFO gateway.run: Secret redaction: ENABLED (tool output, logs, and chat responses are scrubbed before delivery)
2026-05-16 11:20:16,446 INFO gateway.run: Previous gateway exited cleanly — skipping session suspension
2026-05-16 11:20:17,990 WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
2026-05-16 11:20:17,991 WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
2026-05-16 11:20:17,991 WARNING gateway.run: No adapter available for matrix
2026-05-16 11:20:17,992 INFO gateway.run: Connecting to webhook...
2026-05-16 11:20:18,004 INFO gateway.platforms.webhook: [webhook] Listening on 0.0.0.0:8644 — routes: (none configured)
2026-05-16 11:20:18,006 INFO gateway.run: ✓ webhook connected
2026-05-16 11:20:18,007 INFO gateway.run: Gateway running with 1 platform(s)
2026-05-16 11:20:18,010 INFO gateway.run: Channel directory built: 2 target(s)
2026-05-16 11:20:19,012 INFO gateway.run: Press Ctrl+C to stop
2026-05-16 11:20:19,023 INFO gateway.run: Cron ticker started (interval=60s)
2026-05-16 11:20:24,019 INFO gateway.run: kanban dispatcher: embedded in gateway (interval=60.0s)
2026-05-16 11:24:50,367 INFO gateway.run: Received SIGINT as a planned gateway stop — exiting cleanly
2026-05-16 11:24:50,367 WARNING gateway.run: Shutdown context: signal=SIGINT under_systemd=no parent_pid=516904 parent_name=zsh loadavg_1m=0.09 parent_cmdline='-zsh'
2026-05-16 11:24:50,368 INFO gateway.run: Stopping gateway...
2026-05-16 11:24:50,368 INFO gateway.run: Shutdown phase: notify_active_sessions done at +0.00s
2026-05-16 11:24:50,378 INFO gateway.run: Shutdown phase: drain done at +0.01s (drain took 0.01s, timed_out=False, active_at_start=0, active_now=0)
2026-05-16 11:24:50,380 INFO gateway.platforms.webhook: [webhook] Disconnected
2026-05-16 11:24:50,380 INFO gateway.run: ✓ webhook disconnected (0.00s)
2026-05-16 11:24:50,380 INFO gateway.run: Shutdown phase: all adapters disconnected at +0.01s
2026-05-16 11:24:50,408 INFO gateway.run: Shutdown phase: final-cleanup tool kill done at +0.04s
2026-05-16 11:24:50,408 INFO gateway.run: Shutdown phase: SessionDB close done at +0.04s
2026-05-16 11:24:50,410 INFO gateway.run: Gateway stopped (total teardown 0.04s)
2026-05-16 11:24:50,410 INFO gateway.run: Cron ticker stopped
2026-05-16 11:24:56,552 INFO gateway.run: Starting Hermes Gateway...
2026-05-16 11:24:56,552 INFO gateway.run: Session storage: /home/sgiath/hermes/.hermes/sessions
2026-05-16 11:24:56,561 WARNING gateway.run: Stale systemd unit detected: hermes-agent.service has TimeoutStopSec=90s but drain_timeout=180s (expected >=210s). systemd may SIGKILL the gateway mid-drain. Run `hermes gateway service install --replace` to regenerate the unit, or shorten agent.restart_drain_timeout.
2026-05-16 11:24:56,561 INFO gateway.run: Agent budget: max_iterations=150 (agent.max_turns from config.yaml, or HERMES_MAX_ITERATIONS from .env, or default 90)
2026-05-16 11:24:56,562 INFO gateway.run: Secret redaction: ENABLED (tool output, logs, and chat responses are scrubbed before delivery)
2026-05-16 11:24:56,576 INFO gateway.run: Previous gateway exited cleanly — skipping session suspension
2026-05-16 11:24:57,720 WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
2026-05-16 11:24:57,720 WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
2026-05-16 11:24:57,720 WARNING gateway.run: No adapter available for matrix
2026-05-16 11:24:57,721 INFO gateway.run: Connecting to webhook...
2026-05-16 11:24:57,733 INFO gateway.platforms.webhook: [webhook] Listening on 0.0.0.0:8644 — routes: (none configured)
2026-05-16 11:24:57,736 INFO gateway.run: ✓ webhook connected
2026-05-16 11:24:57,737 INFO gateway.run: Gateway running with 1 platform(s)
2026-05-16 11:24:57,740 INFO gateway.run: Channel directory built: 2 target(s)
2026-05-16 11:24:58,742 INFO gateway.run: Press Ctrl+C to stop
2026-05-16 11:24:58,753 INFO gateway.run: Cron ticker started (interval=60s)
2026-05-16 11:25:03,749 INFO gateway.run: kanban dispatcher: embedded in gateway (interval=60.0s)

Code Example

WARNING hermes_cli.plugins: Failed to load plugin 'google_chat-platform': 'google_chat' is not a valid Platform
WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
WARNING gateway.run: No adapter available for matrix

---

2026-05-16 11:20:15,259 WARNING gateway.run: Shutdown context: signal=SIGTERM under_systemd=yes parent_pid=1 parent_name=systemd loadavg_1m=0.24 parent_cmdline='/run/current-system/systemd/lib/systemd/systemd --switched-root --system --deserialize=43'
2026-05-16 11:20:15,260 INFO gateway.run: Stopping gateway...
2026-05-16 11:20:15,260 INFO gateway.run: Shutdown phase: notify_active_sessions done at +0.00s
2026-05-16 11:20:15,262 INFO gateway.run: Shutdown phase: drain done at +0.00s (drain took 0.00s, timed_out=False, active_at_start=0, active_now=0)
2026-05-16 11:20:15,264 INFO gateway.platforms.webhook: [webhook] Disconnected
2026-05-16 11:20:15,264 INFO gateway.run: ✓ webhook disconnected (0.00s)
2026-05-16 11:20:15,264 INFO gateway.run: Shutdown phase: all adapters disconnected at +0.00s
2026-05-16 11:20:15,291 INFO gateway.run: Shutdown phase: final-cleanup tool kill done at +0.03s
2026-05-16 11:20:15,294 INFO gateway.run: Shutdown phase: SessionDB close done at +0.03s
2026-05-16 11:20:15,296 INFO gateway.run: Gateway stopped (total teardown 0.04s)
2026-05-16 11:20:15,296 INFO gateway.run: Cron ticker stopped
2026-05-16 11:20:16,430 INFO gateway.run: Starting Hermes Gateway...
2026-05-16 11:20:16,430 INFO gateway.run: Session storage: /home/sgiath/hermes/.hermes/sessions
2026-05-16 11:20:16,431 INFO gateway.run: Agent budget: max_iterations=150 (agent.max_turns from config.yaml, or HERMES_MAX_ITERATIONS from .env, or default 90)
2026-05-16 11:20:16,431 INFO gateway.run: Secret redaction: ENABLED (tool output, logs, and chat responses are scrubbed before delivery)
2026-05-16 11:20:16,446 INFO gateway.run: Previous gateway exited cleanly — skipping session suspension
2026-05-16 11:20:17,990 WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
2026-05-16 11:20:17,991 WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
2026-05-16 11:20:17,991 WARNING gateway.run: No adapter available for matrix
2026-05-16 11:20:17,992 INFO gateway.run: Connecting to webhook...
2026-05-16 11:20:18,004 INFO gateway.platforms.webhook: [webhook] Listening on 0.0.0.0:8644 — routes: (none configured)
2026-05-16 11:20:18,006 INFO gateway.run: ✓ webhook connected
2026-05-16 11:20:18,007 INFO gateway.run: Gateway running with 1 platform(s)
2026-05-16 11:20:18,010 INFO gateway.run: Channel directory built: 2 target(s)
2026-05-16 11:20:19,012 INFO gateway.run: Press Ctrl+C to stop
2026-05-16 11:20:19,023 INFO gateway.run: Cron ticker started (interval=60s)
2026-05-16 11:20:24,019 INFO gateway.run: kanban dispatcher: embedded in gateway (interval=60.0s)
2026-05-16 11:24:50,367 INFO gateway.run: Received SIGINT as a planned gateway stop — exiting cleanly
2026-05-16 11:24:50,367 WARNING gateway.run: Shutdown context: signal=SIGINT under_systemd=no parent_pid=516904 parent_name=zsh loadavg_1m=0.09 parent_cmdline='-zsh'
2026-05-16 11:24:50,368 INFO gateway.run: Stopping gateway...
2026-05-16 11:24:50,368 INFO gateway.run: Shutdown phase: notify_active_sessions done at +0.00s
2026-05-16 11:24:50,378 INFO gateway.run: Shutdown phase: drain done at +0.01s (drain took 0.01s, timed_out=False, active_at_start=0, active_now=0)
2026-05-16 11:24:50,380 INFO gateway.platforms.webhook: [webhook] Disconnected
2026-05-16 11:24:50,380 INFO gateway.run: ✓ webhook disconnected (0.00s)
2026-05-16 11:24:50,380 INFO gateway.run: Shutdown phase: all adapters disconnected at +0.01s
2026-05-16 11:24:50,408 INFO gateway.run: Shutdown phase: final-cleanup tool kill done at +0.04s
2026-05-16 11:24:50,408 INFO gateway.run: Shutdown phase: SessionDB close done at +0.04s
2026-05-16 11:24:50,410 INFO gateway.run: Gateway stopped (total teardown 0.04s)
2026-05-16 11:24:50,410 INFO gateway.run: Cron ticker stopped
2026-05-16 11:24:56,552 INFO gateway.run: Starting Hermes Gateway...
2026-05-16 11:24:56,552 INFO gateway.run: Session storage: /home/sgiath/hermes/.hermes/sessions
2026-05-16 11:24:56,561 WARNING gateway.run: Stale systemd unit detected: hermes-agent.service has TimeoutStopSec=90s but drain_timeout=180s (expected >=210s). systemd may SIGKILL the gateway mid-drain. Run `hermes gateway service install --replace` to regenerate the unit, or shorten agent.restart_drain_timeout.
2026-05-16 11:24:56,561 INFO gateway.run: Agent budget: max_iterations=150 (agent.max_turns from config.yaml, or HERMES_MAX_ITERATIONS from .env, or default 90)
2026-05-16 11:24:56,562 INFO gateway.run: Secret redaction: ENABLED (tool output, logs, and chat responses are scrubbed before delivery)
2026-05-16 11:24:56,576 INFO gateway.run: Previous gateway exited cleanly — skipping session suspension
2026-05-16 11:24:57,720 WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
2026-05-16 11:24:57,720 WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
2026-05-16 11:24:57,720 WARNING gateway.run: No adapter available for matrix
2026-05-16 11:24:57,721 INFO gateway.run: Connecting to webhook...
2026-05-16 11:24:57,733 INFO gateway.platforms.webhook: [webhook] Listening on 0.0.0.0:8644 — routes: (none configured)
2026-05-16 11:24:57,736 INFO gateway.run: ✓ webhook connected
2026-05-16 11:24:57,737 INFO gateway.run: Gateway running with 1 platform(s)
2026-05-16 11:24:57,740 INFO gateway.run: Channel directory built: 2 target(s)
2026-05-16 11:24:58,742 INFO gateway.run: Press Ctrl+C to stop
2026-05-16 11:24:58,753 INFO gateway.run: Cron ticker started (interval=60s)
2026-05-16 11:25:03,749 INFO gateway.run: kanban dispatcher: embedded in gateway (interval=60.0s)

---
RAW_BUFFERClick to expand / collapse

Bug Description

Mautrix package is not included in the Nix package so when using Hermes through flake the Matrix is not working.

It was working on 0.13.0 this is regression introduced by version 0.14.0

Steps to Reproduce

  1. Install hermes through Nix flake
  2. Configure Matrix channel
  3. Start hermes
  4. Send message to it through Matrix

Expected Behavior

Hermes receives the message and responds

Actual Behavior

Nothing happens. These are the startup logs:

WARNING hermes_cli.plugins: Failed to load plugin 'google_chat-platform': 'google_chat' is not a valid Platform
WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
WARNING gateway.run: No adapter available for matrix

Affected Component

Gateway (Telegram/Discord/Slack/WhatsApp)

Messaging Platform (if gateway-related)

N/A (CLI only)

Debug Report

2026-05-16 11:20:15,259 WARNING gateway.run: Shutdown context: signal=SIGTERM under_systemd=yes parent_pid=1 parent_name=systemd loadavg_1m=0.24 parent_cmdline='/run/current-system/systemd/lib/systemd/systemd --switched-root --system --deserialize=43'
2026-05-16 11:20:15,260 INFO gateway.run: Stopping gateway...
2026-05-16 11:20:15,260 INFO gateway.run: Shutdown phase: notify_active_sessions done at +0.00s
2026-05-16 11:20:15,262 INFO gateway.run: Shutdown phase: drain done at +0.00s (drain took 0.00s, timed_out=False, active_at_start=0, active_now=0)
2026-05-16 11:20:15,264 INFO gateway.platforms.webhook: [webhook] Disconnected
2026-05-16 11:20:15,264 INFO gateway.run: ✓ webhook disconnected (0.00s)
2026-05-16 11:20:15,264 INFO gateway.run: Shutdown phase: all adapters disconnected at +0.00s
2026-05-16 11:20:15,291 INFO gateway.run: Shutdown phase: final-cleanup tool kill done at +0.03s
2026-05-16 11:20:15,294 INFO gateway.run: Shutdown phase: SessionDB close done at +0.03s
2026-05-16 11:20:15,296 INFO gateway.run: Gateway stopped (total teardown 0.04s)
2026-05-16 11:20:15,296 INFO gateway.run: Cron ticker stopped
2026-05-16 11:20:16,430 INFO gateway.run: Starting Hermes Gateway...
2026-05-16 11:20:16,430 INFO gateway.run: Session storage: /home/sgiath/hermes/.hermes/sessions
2026-05-16 11:20:16,431 INFO gateway.run: Agent budget: max_iterations=150 (agent.max_turns from config.yaml, or HERMES_MAX_ITERATIONS from .env, or default 90)
2026-05-16 11:20:16,431 INFO gateway.run: Secret redaction: ENABLED (tool output, logs, and chat responses are scrubbed before delivery)
2026-05-16 11:20:16,446 INFO gateway.run: Previous gateway exited cleanly — skipping session suspension
2026-05-16 11:20:17,990 WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
2026-05-16 11:20:17,991 WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
2026-05-16 11:20:17,991 WARNING gateway.run: No adapter available for matrix
2026-05-16 11:20:17,992 INFO gateway.run: Connecting to webhook...
2026-05-16 11:20:18,004 INFO gateway.platforms.webhook: [webhook] Listening on 0.0.0.0:8644 — routes: (none configured)
2026-05-16 11:20:18,006 INFO gateway.run: ✓ webhook connected
2026-05-16 11:20:18,007 INFO gateway.run: Gateway running with 1 platform(s)
2026-05-16 11:20:18,010 INFO gateway.run: Channel directory built: 2 target(s)
2026-05-16 11:20:19,012 INFO gateway.run: Press Ctrl+C to stop
2026-05-16 11:20:19,023 INFO gateway.run: Cron ticker started (interval=60s)
2026-05-16 11:20:24,019 INFO gateway.run: kanban dispatcher: embedded in gateway (interval=60.0s)
2026-05-16 11:24:50,367 INFO gateway.run: Received SIGINT as a planned gateway stop — exiting cleanly
2026-05-16 11:24:50,367 WARNING gateway.run: Shutdown context: signal=SIGINT under_systemd=no parent_pid=516904 parent_name=zsh loadavg_1m=0.09 parent_cmdline='-zsh'
2026-05-16 11:24:50,368 INFO gateway.run: Stopping gateway...
2026-05-16 11:24:50,368 INFO gateway.run: Shutdown phase: notify_active_sessions done at +0.00s
2026-05-16 11:24:50,378 INFO gateway.run: Shutdown phase: drain done at +0.01s (drain took 0.01s, timed_out=False, active_at_start=0, active_now=0)
2026-05-16 11:24:50,380 INFO gateway.platforms.webhook: [webhook] Disconnected
2026-05-16 11:24:50,380 INFO gateway.run: ✓ webhook disconnected (0.00s)
2026-05-16 11:24:50,380 INFO gateway.run: Shutdown phase: all adapters disconnected at +0.01s
2026-05-16 11:24:50,408 INFO gateway.run: Shutdown phase: final-cleanup tool kill done at +0.04s
2026-05-16 11:24:50,408 INFO gateway.run: Shutdown phase: SessionDB close done at +0.04s
2026-05-16 11:24:50,410 INFO gateway.run: Gateway stopped (total teardown 0.04s)
2026-05-16 11:24:50,410 INFO gateway.run: Cron ticker stopped
2026-05-16 11:24:56,552 INFO gateway.run: Starting Hermes Gateway...
2026-05-16 11:24:56,552 INFO gateway.run: Session storage: /home/sgiath/hermes/.hermes/sessions
2026-05-16 11:24:56,561 WARNING gateway.run: Stale systemd unit detected: hermes-agent.service has TimeoutStopSec=90s but drain_timeout=180s (expected >=210s). systemd may SIGKILL the gateway mid-drain. Run `hermes gateway service install --replace` to regenerate the unit, or shorten agent.restart_drain_timeout.
2026-05-16 11:24:56,561 INFO gateway.run: Agent budget: max_iterations=150 (agent.max_turns from config.yaml, or HERMES_MAX_ITERATIONS from .env, or default 90)
2026-05-16 11:24:56,562 INFO gateway.run: Secret redaction: ENABLED (tool output, logs, and chat responses are scrubbed before delivery)
2026-05-16 11:24:56,576 INFO gateway.run: Previous gateway exited cleanly — skipping session suspension
2026-05-16 11:24:57,720 WARNING gateway.platforms.matrix: Matrix: mautrix not installed. Run: pip install 'mautrix[encryption]'
2026-05-16 11:24:57,720 WARNING gateway.run: Matrix: mautrix not installed or credentials not set. Run: pip install 'mautrix[encryption]'
2026-05-16 11:24:57,720 WARNING gateway.run: No adapter available for matrix
2026-05-16 11:24:57,721 INFO gateway.run: Connecting to webhook...
2026-05-16 11:24:57,733 INFO gateway.platforms.webhook: [webhook] Listening on 0.0.0.0:8644 — routes: (none configured)
2026-05-16 11:24:57,736 INFO gateway.run: ✓ webhook connected
2026-05-16 11:24:57,737 INFO gateway.run: Gateway running with 1 platform(s)
2026-05-16 11:24:57,740 INFO gateway.run: Channel directory built: 2 target(s)
2026-05-16 11:24:58,742 INFO gateway.run: Press Ctrl+C to stop
2026-05-16 11:24:58,753 INFO gateway.run: Cron ticker started (interval=60s)
2026-05-16 11:25:03,749 INFO gateway.run: kanban dispatcher: embedded in gateway (interval=60.0s)

Operating System

NixOS Unstable

Python Version

No response

Hermes Version

0.14.0

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