Skip to content

[Bug]: Switch to mautrix-python breaks matrix gateway integration #7803

@cgarwood82

Description

@cgarwood82

Bug Description

Running update pulls mautrix-python which results in a breaking change for Matrix. Error is clearly called out in the gateway log:

2026-04-11 11:33:02,529 INFO gateway.run: Starting Hermes Gateway...
2026-04-11 11:33:02,529 INFO gateway.run: Session storage: /home/secret/.hermes/sessions
2026-04-11 11:33:02,642 INFO gateway.run: Connecting to matrix...
2026-04-11 11:33:02,842 INFO gateway.platforms.matrix: Matrix: using access token for @meow:secret (device secret)
2026-04-11 11:33:02,842 ERROR gateway.platforms.matrix: Matrix: failed to create E2EE client: MemoryCryptoStore.__init__() missing 2 required positional arguments: 'account_id' and 'pickle_key'. Install with: pip install 'mautrix[encryption]'  (requires libolm C library)
2026-04-11 11:33:02,842 WARNING gateway.run: ✗ matrix failed to connect
2026-04-11 11:33:02,842 ERROR gateway.run: Gateway failed to connect any configured messaging platform: matrix: failed to connect

Version info:
Hermes Agent v0.8.0 (2026.4.8)
Project: /home/trans/.hermes/hermes-agent
Python: 3.11.15
OpenAI SDK: 2.31.0
Up to date

Steps to Reproduce

On a system correctly working with previous matrix-nio for matrix integration on the gateway, run hermes update

Expected Behavior

gateway restart should work with existing configuration or prompt user to change configuration

Actual Behavior

Gateway will not connect to matrix:

2026-04-11 11:33:02,529 INFO gateway.run: Starting Hermes Gateway...
2026-04-11 11:33:02,529 INFO gateway.run: Session storage: /home/secret/.hermes/sessions
2026-04-11 11:33:02,642 INFO gateway.run: Connecting to matrix...
2026-04-11 11:33:02,842 INFO gateway.platforms.matrix: Matrix: using access token for @meow:secret (device secret)
2026-04-11 11:33:02,842 ERROR gateway.platforms.matrix: Matrix: failed to create E2EE client: MemoryCryptoStore.__init__() missing 2 required positional arguments: 'account_id' and 'pickle_key'. Install with: pip install 'mautrix[encryption]'  (requires libolm C library)
2026-04-11 11:33:02,842 WARNING gateway.run: ✗ matrix failed to connect
2026-04-11 11:33:02,842 ERROR gateway.run: Gateway failed to connect any configured messaging platform: matrix: failed to connect

Affected Component

Gateway (Telegram/Discord/Slack/WhatsApp)

Messaging Platform (if gateway-related)

No response

Operating System

Arch Linux

Python Version

Python 3.11.15

Hermes Version

Hermes Agent v0.8.0 (2026.4.8)

Relevant Logs / Traceback

2026-04-11 11:33:02,529 INFO gateway.run: Starting Hermes Gateway...
2026-04-11 11:33:02,529 INFO gateway.run: Session storage: /home/secret/.hermes/sessions
2026-04-11 11:33:02,642 INFO gateway.run: Connecting to matrix...
2026-04-11 11:33:02,842 INFO gateway.platforms.matrix: Matrix: using access token for @meow:secret (device secret)
2026-04-11 11:33:02,842 ERROR gateway.platforms.matrix: Matrix: failed to create E2EE client: MemoryCryptoStore.__init__() missing 2 required positional arguments: 'account_id' and 'pickle_key'. Install with: pip install 'mautrix[encryption]'  (requires libolm C library)
2026-04-11 11:33:02,842 WARNING gateway.run: ✗ matrix failed to connect
2026-04-11 11:33:02,842 ERROR gateway.run: Gateway failed to connect any configured messaging platform: matrix: 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