README.md

August 10, 2026 · View on GitHub

MIT licensed CI CodeQL Read the Docs Python Version Python Wheel PyPI PyPI Downloads OpenSSF Baseline OpenSSF Best Practices OSSF-Scorecard Score Discord docs/assets/amqtt.svg

aMQTT is an open source MQTT broker and client1, natively implemented with Python's asyncio.

Features

  • Full set of MQTT 3.1.1 protocol specifications

  • Communication over multiple TCP and/or websocket ports, including support for SSL/TLS

  • Support QoS 0, QoS 1 and QoS 2 messages flow

  • Client auto-reconnection on network lost

  • Plugin framework for functionality expansion; included plugins:

    • $SYS topic publishing
    • AWS IOT-style shadow states
    • x509 certificate authentication (including cli cert creation)
    • Secure file-based password authentication
    • Configuration-based topic authorization
    • MySQL, Postgres & SQLite user and/or topic auth (including cli manager)
    • External server (HTTP) user and/or topic auth
    • LDAP user and/or topic auth
    • JWT user and/or topic auth
    • Fail over session persistence

Installation

amqtt is available on PyPI

$ pip install amqtt

Documentation

Available on Read the Docs.

Containerization

Launch from DockerHub

$ docker run -d -p 1883:1883 amqtt/amqtt:latest

Testing

The amqtt project runs a test aMQTT broker/server at test.amqtt.io which supports: MQTT, MQTT over TLS, websocket, secure websockets.

Support

Bug reports, patches and suggestions welcome! Just open an issue or join the discord community.

Please report security vulnerabilities privately according to the security policy.

Python Version Compatibility

Versionhbmqtt compatibilitySupported Python Versions
0.10.xyes 23.7 - 3.9
0.11.xno 33.10 - 3.13
0.12.xno 33.10 - 3.14

Footnotes

  1. Forked from HBMQTT after it was deprecated by the original author. ↩

  2. drop-in replacement ↩

  3. module renamed and small API differences ↩ ↩2