Skip to main content

pymqttd

A small MQTT 3.1.1 broker you can pip install. It is rumqttd (Rust) built as an executable and shipped in a wheel, with a Python launcher that runs it as a child process.

It is meant for an application that needs a broker on the same host and cannot count on one being installed: start it on a free local port, connect your clients, and it goes away with your process.

pip install pymqttd

From Python

import pymqttd

async with pymqttd.Broker() as broker:          # 127.0.0.1, a free port
    print(broker.port)

Without asyncio:

with pymqttd.BrokerProcess() as broker:
    print(broker.port)

Both take host, port (0, the default, picks a free one), username and password (together; anonymous clients are then refused), max_payload_size (bytes, default 1 MiB) and log (rumqttd's log filter, off by default). start() returns once the broker accepts MQTT connections and raises pymqttd.BrokerError if it cannot start.

The broker runs in its own process, so a busy or blocked Python process does not slow it down. It exits when its parent does, however the parent ends: it watches the stdin pipe the parent holds.

From the command line

pymqttd --host 127.0.0.1 --port 1883
python -m pymqttd --help

Once it accepts connections it prints ready <host>:<port> on stdout. --exit-on-stdin-close makes it exit when stdin reaches end of file.

Limits

  • MQTT 3.1.1 over plain TCP. No TLS, no websockets, no MQTT 5.
  • Retained messages and sessions live in memory: they are gone when the broker stops.
  • rumqttd logs every client disconnect, clean ones included, as an error, so its log is off unless you pass --log (log= in Python).

Licence

MIT. The executable includes rumqttd, which is licensed under Apache-2.0.

Metadata

Release files for pymqttd 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pymqttd 0.1.0
File Size Uploaded Provenance Actions
pymqttd-0.1.0.tar.gz 24.3 kB With provenance Details for pymqttd-0.1.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for pymqttd 0.1.0
File Actions
pymqttd-0.1.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for pymqttd-0.1.0-py3-none-win_amd64.whl
pymqttd-0.1.0-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for pymqttd-0.1.0-py3-none-musllinux_1_2_x86_64.whl
pymqttd-0.1.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for pymqttd-0.1.0-py3-none-musllinux_1_2_aarch64.whl
pymqttd-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for pymqttd-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
pymqttd-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for pymqttd-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
pymqttd-0.1.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for pymqttd-0.1.0-py3-none-macosx_11_0_arm64.whl
pymqttd-0.1.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for pymqttd-0.1.0-py3-none-macosx_10_12_x86_64.whl

Total release size: 11.2 MB

Release files / pymqttd-0.1.0.tar.gz

Download URL pymqttd-0.1.0.tar.gz
Size 24.3 kB
Tags Source
SHA-256 checksum
How to use checksums
ab715ebbaf75ea7bf5f143bdc543d2847b51c0ea69b44adc3d787e9da699fb3a
BLAKE2b-256 checksum
How to use checksums
abfc2892871cec1393e2cab2704bb8558edd37329b5148726bde8a8f88e5bb73
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / pymqttd-0.1.0-py3-none-win_amd64.whl

Download URL pymqttd-0.1.0-py3-none-win_amd64.whl
Size 1.7 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
775bcaeb66ed94d8bc618b75e85326cf2ad7dafe37012b6d561195e2918841e6
BLAKE2b-256 checksum
How to use checksums
b98db7f4bd231da74656c3c397558b67fff0e1ca1984bf3695a1b7671b4879db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / pymqttd-0.1.0-py3-none-musllinux_1_2_x86_64.whl

Download URL pymqttd-0.1.0-py3-none-musllinux_1_2_x86_64.whl
Size 1.7 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
962d119298bf7fa9eb6a302b03109bbf0f18214a3f2043e2746fdc857520e126
BLAKE2b-256 checksum
How to use checksums
b6ea00a6ed9def001bdcadd7c78c5564102e996ae7157dda7e72fcd8ebe57b8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / pymqttd-0.1.0-py3-none-musllinux_1_2_aarch64.whl

Download URL pymqttd-0.1.0-py3-none-musllinux_1_2_aarch64.whl
Size 1.6 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
8480ad47aee9b5d85ed4730913e2de7927424ee7415bdf1132f98333f608812b
BLAKE2b-256 checksum
How to use checksums
9916fc493c1d65e28ce0475e79f742aa3a982a976f3a0aa4c661ae73ee29c8b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / pymqttd-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL pymqttd-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 1.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
9eeaf8030964912efe055d68c68b5903d761e33415c05f7654e0dbee9b72a3f8
BLAKE2b-256 checksum
How to use checksums
ce8f1dbdb37630b02ffde47e7e0bbac3456eb0a2444a5682396c3aa4334d7e3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / pymqttd-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL pymqttd-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 1.5 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
624498dd7f149c6ef163b59280cbf14636e7ca6781dcf51758d26f24b4f8f63c
BLAKE2b-256 checksum
How to use checksums
b965fe2b951ba51f32362e0514caf2725ae3a3d138caebb1d3304254bdb48168
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / pymqttd-0.1.0-py3-none-macosx_11_0_arm64.whl

Download URL pymqttd-0.1.0-py3-none-macosx_11_0_arm64.whl
Size 1.5 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
99ccde428e5c3f318f3335bb1525bbb4ac2be703b02c896e5c769325bfbcdcc3
BLAKE2b-256 checksum
How to use checksums
5da2746c398df86ec6cf177d766020173402c1a169b93b417308f3b30f7da267
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / pymqttd-0.1.0-py3-none-macosx_10_12_x86_64.whl

Download URL pymqttd-0.1.0-py3-none-macosx_10_12_x86_64.whl
Size 1.6 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
ad6774e529f4bbea41fcd762f088bdaec88d381ad31786be5d0b78d92994bd22
BLAKE2b-256 checksum
How to use checksums
5daec27f1324ccb403be5eaa5fedf08b4437a0f2bbc52d99687e8d4294e95b58
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Security for pymqttd 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 8 files in this release have been uploaded with provenance metadata.

Select from 8 files

Attestation for pymqttd-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page