aMQTT is an open source MQTT client and broker implementation in python
 
 
 
 
 
 
Go to file
Andrew Mirsky c72ddfa334
creating contrib package for plugins requiring extra dependencies
2025-07-08 22:28:56 -04:00
.github update workflow with correct install packages 2025-07-08 05:52:18 -04:00
amqtt creating contrib package for plugins requiring extra dependencies 2025-07-08 22:28:56 -04:00
docs creating contrib package for plugins requiring extra dependencies 2025-07-08 22:28:56 -04:00
docs_test Merge branch '0.11.1-rc' into add_client_display 2025-06-26 13:52:47 -04:00
docs_web updated documentation 2025-07-07 20:23:31 -04:00
samples additional test cases for the session persistence plugin. fixed bug with reconnected session missing updated session configuration 2025-07-07 18:36:37 -04:00
scripts refactor: update base project confs 2025-04-04 21:06:41 +02:00
tests creating contrib package for plugins requiring extra dependencies 2025-07-08 22:28:56 -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 using 'n' messages to force amqtt_sub to exit, instead of SIGINT which seems to cause the process to force quit instead of causing a keyboard interupt 2025-06-03 18:29:13 -04:00
.readthedocs.yaml running pytest to generate htmlcov for readthedocs 2025-06-12 14:20:31 -04:00
CODE_OF_CONDUCT.md updating client documentation by converting rst format into google docstring params, including examples from reference file 2025-05-21 21:59:12 -04:00
CONTRIBUTING.md updating client documentation by converting rst format into google docstring params, including examples from reference file 2025-05-21 21:59:12 -04:00
Dockerfile dockerfile build update to support psutils 2025-06-27 13:40:21 -04:00
LICENSE.md updating client documentation by converting rst format into google docstring params, including examples from reference file 2025-05-21 21:59:12 -04:00
MANIFEST.in
Makefile dockerfile build update to support psutils 2025-06-27 13:40:21 -04:00
README.md updated documentation 2025-07-07 20:23:31 -04:00
SECURITY.md
SUPPORT.md consolidating configuration documentation for both broker and client. including making sure there's consistency in default configuration 2025-05-28 07:45:12 -04:00
mkdocs.rtd.yml creating contrib package for plugins requiring extra dependencies 2025-07-08 22:28:56 -04:00
mkdocs.web.yml updating docs, version numbers and ssl 2025-06-16 15:24:23 -04:00
pyproject.toml creating contrib package for plugins requiring extra dependencies 2025-07-08 22:28:56 -04:00
uv.lock creating contrib package for plugins requiring extra dependencies 2025-07-08 22:28:56 -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
  • Custom functionality expansion; plugins included: authentication, $SYS topic publishing, 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.

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 ↩︎