Project Links

Meta

Author: Brian E. Granger, Min Ragan-Kelley

Requires Python: >=3.8

Classifiers

Development Status

5 - Production/Stable

Intended Audience

Developers
Science/Research
System Administrators

License

OSI Approved :: BSD License

Operating System

MacOS :: MacOS X
Microsoft :: Windows
POSIX

Topic

System :: Networking

Programming Language

Python :: 3
Python :: 3 :: Only
Python :: 3.8
Python :: 3.9
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13

PyZMQ: Python bindings for ØMQ

This package contains Python bindings for ZeroMQ. ØMQ is a lightweight and fast messaging implementation.

PyZMQ should work with any reasonable version of Python (≥ 3.8), as well as PyPy. PyZMQ supports libzmq ≥ 3.2.2 (including 4.x).

For a summary of changes to pyzmq, see our changelog.

ØMQ 3.x, 4.x

PyZMQ fully supports the stable (not DRAFT) 3.x and 4.x APIs of libzmq, developed at zeromq/libzmq. No code to change, no flags to pass, just build pyzmq against the latest and it should work.

Documentation

See PyZMQ's Sphinx-generated documentation on Read the Docs for API details, and some notes on Python and Cython development. If you want to learn about using ØMQ in general, the excellent ØMQ Guide is the place to start, which has a Python version of every example. We also have some information on our wiki.

Downloading

Unless you specifically want to develop PyZMQ, we recommend downloading the PyZMQ source code or wheels from PyPI, or install with conda.

You can also get the latest source code from our GitHub repository, but building from the repository will require that you install recent Cython.

Building and installation

For more detail on building pyzmq, see our docs.

We build wheels for macOS, Windows, and Linux, so you can get a binary on those platforms with:

pip install pyzmq

but compiling from source with pip install pyzmq should work in most environments. Make sure you are using the latest pip, or it may not find the right wheels.

If the wheel doesn't work for some reason, or you want to force pyzmq to be compiled (this is often preferable if you already have libzmq installed and configured the way you want it), you can force installation from source with:

pip install --no-binary=pyzmq pyzmq

Old versions

pyzmq 16 drops support Python 2.6 and 3.2. If you need to use one of those Python versions, you can pin your pyzmq version to before 16:

pip install 'pyzmq<16'

For libzmq 2.0.x, use 'pyzmq<2.1'

pyzmq-2.1.11 was the last version of pyzmq to support Python 2.5, and pyzmq ≥ 2.2.0 requires Python ≥ 2.6. pyzmq-13.0.0 introduces PyPy support via CFFI, which only supports libzmq-3.2.2 and newer.

PyZMQ releases ≤ 2.2.0 matched libzmq versioning, but this is no longer the case, starting with PyZMQ 13.0.0 (it was the thirteenth release, so why not?). PyZMQ ≥ 13.0 follows semantic versioning conventions accounting only for PyZMQ itself.

26.0.0b2 Mar 06, 2024

26.0.0b1 Feb 27, 2024

26.0.0a6 Feb 23, 2024

26.0.0a5 Feb 21, 2024

26.0.0a4 Feb 19, 2024

26.0.0a3 Feb 19, 2024

26.0.0a2 Feb 17, 2024

26.0.0a1 Feb 17, 2024

25.1.2 Dec 05, 2023

25.1.1 Aug 10, 2023

25.1.1b2 Jul 12, 2023

25.1.1b1 May 31, 2023

25.0.0b1 Oct 11, 2022

23.0.0b2 May 09, 2022

23.0.0b1 Mar 07, 2022

17.0.0b4 Jan 24, 2018

17.0.0b3 Nov 10, 2017

17.0.0b2 Nov 03, 2017

17.0.0b1 Aug 16, 2017

15.3.0+fix Jul 20, 2016

2.0.10.1 Jan 30, 2011

Wheel compatibility matrix

Platform	CPython 3.8	CPython 3.9	CPython 3.10	CPython 3.11	CPython 3.12	CPython 3.13	CPython (additional flags: t) 3.13	PyPy 3.8 (pp73)	PyPy 3.9 (pp73)	PyPy 3.10 (pp73)	PyPy 3.11 (pp73)
macosx_10_15_universal2
macosx_10_15_x86_64
manylinux2010_i686
manylinux2010_x86_64
manylinux2014_aarch64
manylinux2014_i686
manylinux2014_x86_64
manylinux_2_12_i686
manylinux_2_12_x86_64
manylinux_2_17_aarch64
manylinux_2_17_i686
manylinux_2_17_x86_64
manylinux_2_28_x86_64
musllinux_1_1_aarch64
musllinux_1_1_i686
musllinux_1_1_x86_64
win32
win_amd64
win_arm64