Skip to main content

aiomsg (Python)

Pure-Python smart sockets (like ZMQ) for simpler networking — the reference implementation of the aiomsg protocol.

This is the Python member of the multi-language aiomsg family. For the full design narrative, message-distribution cookbook, and TLS guide, see the top-level README. For the on-the-wire spec shared by every language implementation, see PROTOCOL.md.

Install

pip install aiomsg

Quickstart

The end that binds (the "server"):

import asyncio, time
from aiomsg import Søcket

async def main():
    async with Søcket() as sock:
        await sock.bind('127.0.0.1', 25000)
        while True:
            await sock.send(time.ctime().encode())
            await asyncio.sleep(1)

asyncio.run(main())

The end that connects (the "client"):

import asyncio
from aiomsg import Søcket

async def main():
    async with Søcket() as sock:
        await sock.connect('127.0.0.1', 25000)
        async for msg in sock.messages():
            print(msg.decode())

asyncio.run(main())

Both are complete, runnable programs.

Development

This package uses uv and just. From this directory:

just sync     # create the venv with test + lint deps
just test     # run the test suite
just lint     # ruff check
just fmt      # ruff format

Releasing is documented in RELEASING.md.

Metadata

Release files for aiomsg 2026.7.1

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

Source distribution (sdist)

Source distribution for aiomsg 2026.7.1
File Size Uploaded Provenance
aiomsg-2026.7.1.tar.gz 19.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for aiomsg 2026.7.1
File Interpreter ABI Platform
aiomsg-2026.7.1-py3-none-any.whl Python 3 none any Details

Total release size: 41.4 kB

Release files / aiomsg-2026.7.1.tar.gz

Download URL aiomsg-2026.7.1.tar.gz
Size 19.8 kB
Tags Source
SHA-256 checksum
How to use checksums
3136017738ede6793b13a795e0c75ad43c6dd91eecf13ccb1ce21c9aa1151152
BLAKE2b-256 checksum
How to use checksums
30b9b036a622b5049d0a0675a724c18f651f6ebf96c187a2ec330334b62c321e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jul 10, 2026.

Transparency log

Release files / aiomsg-2026.7.1-py3-none-any.whl

Download URL aiomsg-2026.7.1-py3-none-any.whl
Size 21.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f7fbb3e8ad9f5dddcbee2124691729aaa138b434b290cb2a284e01d7fcb7b75f
BLAKE2b-256 checksum
How to use checksums
3a530ac6a6b7d3afb94c1d97c01103c9d0ce4c25c68caa41a5dfbc99f84ea87e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jul 10, 2026.

Transparency log

Security for aiomsg 2026.7.1

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 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aiomsg-2026.7.1.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 Jul 10, 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.

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