mautrix

What it is and what it does

Mautrix is an asyncio-based Python framework for building applications that interact with the Matrix protocol. It sits between raw HTTP and high-level application logic, offering layered abstractions: a basic HTTP client, Matrix Client API endpoints, application service transaction handling, end-to-end encryption support via libolm, and specialized bridging utilities. The framework targets developers building Matrix bots, bridges to other chat systems, or custom Matrix clients.

The package provides utilities for common tasks like HTML parsing, configuration management, database access (via asyncpg or SQLAlchemy), and token signing. It requires Python 3.10+ and depends on aiohttp, attrs, and yarl for async HTTP operations. The codebase is actively maintained and classified as Beta, indicating core functionality is stable but the API may evolve.

Use it for:

• Build a Matrix appservice that bridges messages between Matrix and another chat platform
• Create a Matrix bot that syncs room state and handles encrypted messages
• Implement end-to-end encryption in a custom Matrix client using the crypto framework
• Develop a Matrix application service with transaction support and user/alias query handling
• Build double-puppeting integrations where a bridge controls user accounts on both sides

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

An asyncio Matrix framework for Python that provides HTTP client APIs, application service support, end-to-end encryption, and bridging utilities for building Matrix protocol applications.

Yes, if you are building a Matrix application or bridge. The framework is actively maintained, has low install friction, and provides well-structured abstractions for the full Matrix protocol stack. The copyleft license (MPL 2.0) requires source disclosure if you modify and redistribute, so review your licensing constraints. No known security vulnerabilities as of the fact sheet date.

Install

mautrix on PyPI

pip install mautrix

uv add mautrix

poetry add mautrix

Installing mautrix

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (40 days old) and ongoing repository activity. Requires Python 3.10 or later.

License in practice

Licensed under Mozilla Public License 2.0 (MPL 2.0), a copyleft license. You must disclose source code modifications and distribute under the same license if you modify and redistribute the package.

Quickstart

pip install mautrix

import asyncio
from mautrix.client import Client

async def main():
    client = Client(homeserver="https://matrix.example.com", user_id="@user:example.com")
    # Use client for Matrix operations

asyncio.run(main())

Requires Python 3.10 or later. End-to-end encryption support requires libolm system library (installed via python-olm dependency).

Verify before relying

• Whether libolm system library is required for end-to-end encryption support or if python-olm handles installation
• Specific asyncpg or SQLAlchemy version requirements for database helpers
• Whether all advertised components (bridge, crypto, appservice) are production-ready or still experimental

Package facts

Evidence: mautrix-0.21.1-py3-none-any.whl

Tags

More Chat packages