Skip to content

[Bug]: Matrix messaging channel not functional #1973

@williamtwomey

Description

@williamtwomey

Bug Description

Fresh install, latest version. Configured matrix messaging during setup and gateway refuses to start with:

2026-03-18 13:46:12,041 WARNING gateway.platforms.matrix: Matrix: matrix-nio not installed. Run: pip install 'matrix-nio[e2e]'
2026-03-18 13:46:12,041 WARNING gateway.run: Matrix: matrix-nio not installed or credentials not set. Run: pip install 'matrix-nio[e2e]'
2026-03-18 13:46:12,041 WARNING gateway.run: No adapter available for matrix
2026-03-18 13:46:12,041 ERROR gateway.run: Gateway failed to connect any configured messaging platform: all configured messaging platforms failed to connect

Confirmed matrix packages are not in the uv enviornment, but after installing + restarting gateway no change.

Matrix details are in .hermes/.env

After activating the venv and manually installing it works, looks like an issue with the setup process here.

Steps to Reproduce

  1. Fresh install, configure matrix
  2. Attempt to start gateway, it will fail to start

Expected Behavior

If you select matrix during setup, it should install the python package in the uv venv

Actual Behavior

Setup fails to install matrix package in the uv venv

Affected Component

Gateway (Telegram/Discord/Slack/WhatsApp)

Messaging Platform (if gateway-related)

No response

Operating System

Ubuntu 24.04

Python Version

3.11.15

Hermes Version

v0.4.0 (2026.3.18)

Relevant Logs / Traceback

2026-03-18 13:46:12,041 WARNING gateway.platforms.matrix: Matrix: matrix-nio not installed. Run: pip install 'matrix-nio[e2e]'
2026-03-18 13:46:12,041 WARNING gateway.run: Matrix: matrix-nio not installed or credentials not set. Run: pip install 'matrix-nio[e2e]'
2026-03-18 13:46:12,041 WARNING gateway.run: No adapter available for matrix
2026-03-18 13:46:12,041 ERROR gateway.run: Gateway failed to connect any configured messaging platform: all configured messaging platforms failed to connect

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    type/bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions