Introduction

This documentation aims to cover everything you need to know to use aiomqtt in your projects. We expect some knowledge of MQTT and asyncio, but we try to explain things as clearly as possible. If you get stuck, don’t hesitate to start a new discussion on GitHub. We’re happy to help!

If you’re new to MQTT, we recommend reading the HiveMQ MQTT essentials guide as an introduction. Afterward, the OASIS specification is a great reference. For asyncio, we recommend the RealPython asyncio walkthrough as an introduction and the asyncio docs as a reference.

Thanks for being part of our community! ☀️

A little bit of history

Frederik (@frederikaalund) started aiomqtt in 2020 to power bacteria sensors at SBT Instruments. One of his central ideas for the project was to use structured concurrency principles. The project was called asyncio-mqtt until 2023, when Jonathan (@mossblaser) graciously offered to pass along the aiomqtt name. In August 2024, Frederik passed on aiomqtt’s stewardship to Felix (@empicano) due to changing priorities and to better serve the project overall.