aMQTT is an open source MQTT client and broker implementation in python
 
 
 
 
 
 
Go to file
Andrew Mirsky 364273e684
marking test for broker sys plugin as xfail, because it fails on github workflow but not locally
2025-06-14 15:28:46 -04:00
.github Merge pull request #194 from ajmirsky/issues/55 2025-06-04 10:38:31 -04:00
amqtt Merge pull request #212 from ajmirsky/plugin_call_optimization 2025-06-14 10:19:39 -04:00
docs clarifying documentation 2025-06-13 07:11:49 -04:00
docs_test amqtt.io (#206) 2025-06-11 11:49:09 -04:00
docs_web amqtt.io (#206) 2025-06-11 11:49:09 -04:00
samples amqtt.io (#206) 2025-06-11 11:49:09 -04:00
scripts refactor: update base project confs 2025-04-04 21:06:41 +02:00
tests marking test for broker sys plugin as xfail, because it fails on github workflow but not locally 2025-06-14 15:28:46 -04:00
.codecov.yml
.coveragerc
.gitattributes
.gitignore simplifying the gitignore file so that it is easier to identify what is / isn't included 2025-05-29 13:31:38 -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
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
README.md consistent description in readme file 2025-06-12 14:28:50 -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
dockerfile separating docker build into two phases to minimize image size. add documentation for docker launch / configure 2025-06-09 14:32:55 -04:00
mkdocs.rtd.yml tweaking readthedocs configuration 2025-06-11 16:30:27 -04:00
mkdocs.web.yml amqtt.io (#206) 2025-06-11 11:49:09 -04:00
pyproject.toml Merge branch 'rc' into issues/199 2025-06-14 10:08:34 -04:00
uv.lock loading plugins from config file, bypassing entry points. authenticate and subscribe/publish 2025-06-12 08:37:27 -04:00

README.md

MIT licensed CI CodeQL Documentation Status Join the chat 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

Support

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

Python Version Compatibility

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

For a full feature roadmap, see ...


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

  2. drop-in replacement ↩︎

  3. module renamed and small API differences ↩︎