aMQTT is an open source MQTT client and broker implementation in python
 
 
 
 
 
 
Go to file
Andrew Mirsky d0d875ca30
python 3.10 differentiates between asyncio.TimeoutError and builtin TimeoutError
2025-07-02 14:13:02 -04:00
.github path tweaks for v0.11.0 release 2025-06-17 10:58:48 -04:00
amqtt use MQTT terminology 2025-07-02 13:25:31 -04:00
docs resolves Yakifo/amqtt#27 Yakifo/amqtt#246 Yakifo/amqtt#123: only retain messages for clients which specify clean session = 1 and messages are QoS 1 & 2. Also, clients which are completely anonymous, specifying no username, have no expectation of message retention. 2025-07-01 22:00:18 -04:00
docs_test Merge branch '0.11.1-rc' into add_client_display 2025-06-26 13:52:47 -04:00
docs_web path tweaks for v0.11.0 release 2025-06-17 10:58:48 -04:00
samples remove dependency on external broker 2025-07-02 13:54:26 -04:00
scripts
tests python 3.10 differentiates between asyncio.TimeoutError and builtin TimeoutError 2025-07-02 14:13:02 -04:00
.codecov.yml
.coveragerc
.gitattributes
.gitignore messages for reconnected sessions where clean session is false, need to send retained topic messages 2025-07-02 12:03:14 -04:00
.pre-commit-config.yaml
.readthedocs.yaml running pytest to generate htmlcov for readthedocs 2025-06-12 14:20:31 -04:00
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Dockerfile updating docs, version numbers and ssl 2025-06-16 15:24:23 -04:00
LICENSE.md
MANIFEST.in
Makefile docker build makefile. fix image url for readme so it shows up on pypi 2025-06-17 10:45:21 -04:00
README.md fixed broken link 2025-06-25 19:49:50 -04:00
SECURITY.md
SUPPORT.md
mkdocs.rtd.yml fix mkdoc configuration issue 2025-06-26 14:37:48 -04:00
mkdocs.web.yml updating docs, version numbers and ssl 2025-06-16 15:24:23 -04:00
pyproject.toml release 0.11.1 2025-06-26 14:30:30 -04:00
uv.lock release 0.11.1 2025-06-26 14:30:30 -04:00

README.md

MIT licensed CI CodeQL Read the Docs Discord Python Version Python Wheel PyPI

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 TCP and/or websocket, including support for SSL/TLS
  • Support QoS 0, QoS 1 and QoS 2 messages flow
  • Client auto-reconnection on network lost
  • Functionality expansion; plugins included: authentication and $SYS topic publishing

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.

Python Version Compatibility

Version hbmqtt compatibility Supported Python Versions
0.10.x yes 2 3.7 - 3.9
0.11.x no 3 3.10 - 3.13

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

  2. drop-in replacement ↩︎

  3. module renamed and small API differences ↩︎