aMQTT is an open source MQTT client and broker implementation in python
 
 
 
 
 
 
Go to file
Andrew Mirsky cdcee7cbf8
Merge pull request #281 from ajmirsky/plugin_docs
Expanded structure for plugin documentation
2025-07-30 12:01:18 -04:00
.github Plugin: authentication against a relational database (#280) 2025-07-26 17:04:14 -04:00
amqtt migrate config to use the mkdocs material custom style templates. expand content. 2025-07-30 11:54:20 -04:00
docs migrate config to use the mkdocs material custom style templates. expand content. 2025-07-30 11:54:20 -04:00
docs_test Fixes #247 : expire disconnected sessions (#279) 2025-07-26 21:39:45 -04:00
docs_web
samples add additional documentation for custom plugins 2025-07-10 12:29:59 -04:00
scripts
tests splitting out contrib plugin documentation into separate pages 2025-07-30 09:32:56 -04:00
.codecov.yml
.coveragerc Plugin: authentication against a relational database (#280) 2025-07-26 17:04:14 -04:00
.dockerignore change version numbers for release of 0.11.2 2025-07-09 12:27:22 -04:00
.gitattributes
.gitignore structure needed as the basis for several 0.11.3 improvements 2025-07-10 11:23:56 -04:00
.pre-commit-config.yaml
.readthedocs.yaml
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Dockerfile dockerfile build update to support psutils 2025-06-27 13:40:21 -04:00
LICENSE.md
MANIFEST.in
Makefile structure needed as the basis for several 0.11.3 improvements 2025-07-10 11:23:56 -04:00
README.md
SECURITY.md
SUPPORT.md
mkdocs.rtd.yml splitting out contrib plugin documentation into separate pages 2025-07-30 09:32:56 -04:00
mkdocs.web.yml
pyproject.toml Plugin: authentication against a relational database (#280) 2025-07-26 17:04:14 -04:00
uv.lock Plugin: authentication against a relational database (#280) 2025-07-26 17:04:14 -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 ↩︎