Pre-release

This release is a pre-release and may not be stable for production use.

apache-iggy

Apache Iggy is the persistent message streaming platform written in Rust, supporting QUIC, TCP and HTTP transport protocols, capable of processing millions of messages per second.

Apache Iggy (Incubating) is an effort undergoing incubation at the Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC.

Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects.

While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Installation

Basic Installation

# Using uv in an existing project
uv add apache-iggy

# Using pip
python3 -m venv .venv
source .venv/bin/activate
pip install apache-iggy

Prerequisites

Every installation below compiles the Rust extension, so you'll need:

Python 3.10+
Rust toolchain: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
uv: curl -LsSf https://astral.sh/uv/install.sh | sh
All checks tooling from CONTRIBUTING.md.
Docker

Local Development

IMPORTANT: All commands are supposed to be ran from foreign/python unless it's specified to run in repository's root folder.

Build a project for development

With uv:

# Create a venv
uv venv

# Sync the environment without updating it
uv sync --frozen --all-extras --no-install-project

# Build the project -- this builds the rust extension into the venv (debug profile) - re-run after any rust change
uv run --no-sync maturin develop

With pip:

# Create a venv
python3 -m venv .venv

# Activate the venv
source .venv/bin/activate

# Install the dependencies
pip install -e ".[all]"

# Build the project -- this builds the rust extension into the venv (debug profile) - re-run after any rust change
maturin develop

Run the server to be able to run the tests (this blocks the terminal - run steps 3-5 in a separate one). --fresh deletes local_data/ on every run - drop it if you have existing data you want to keep.
```
# run from the repository's root directory
cargo run --bin iggy-server -- --with-default-root-credentials --fresh
```

Run the tests

uv:

uv run --no-sync pytest tests/ -v

pip:

pytest tests/ -v # make sure iggy-server is running and the venv is activated

To update the stubs, only after changing the pyo3 API surface (nothing in CI checks stub freshness, so unconditional regen just invites .pyi churn), use

# run from foreign/python
cargo run --bin stub_gen
# TODO: Known bug: running this from a subdirectory of `foreign/python` corrupts the tracked stub, see https://github.com/apache/iggy/pull/3825/changes/BASE..773a27971b4ddb7b44773ded395ed23afb1de4c9#r3727691619

Before committing, test the pre-commit and pre-push hooks. prek only inspects staged content, so stage your work first:

git add -A
prek run # runs pre-commit hooks
prek run --hook-stage pre-push
# if a hook modifies files, re-run `git add -A` and `prek run`.

These are some of the essential commands prek is running, so it's recommended to run them manually before running prek / committing / pushing. This list is not exhaustive and other hook failures are possible.

uv run --no-sync ruff format .

uv run --no-sync ruff check --fix .

cargo fmt --manifest-path Cargo.toml

cargo clippy --manifest-path Cargo.toml --all-targets --all-features -- -D warnings

# run from the repository's root directory
./scripts/ci/markdownlint.sh --fix foreign/python/README.md # read the diff after applying this, sometimes it gives unwanted results, e.g. messing up enumerations

Client Configuration

IggyClient takes either a server address or a TcpConfig:

import asyncio
from datetime import timedelta

from apache_iggy import AutoLogin, IggyClient, TcpConfig, TcpReconnectionConfig


async def main():
    client = IggyClient(
        TcpConfig(
            server_address="127.0.0.1:8090",
            auto_login=AutoLogin.username_password("iggy", "iggy"),
            reconnection=TcpReconnectionConfig(
                enabled=True,
                max_retries=10,
                interval=timedelta(seconds=2),
                reestablish_after=timedelta(seconds=30),
            ),
            heartbeat_interval=timedelta(seconds=5),
            # tls_enabled=True,
            # tls_domain="localhost",
            # tls_ca_file="../../core/certs/iggy_ca_cert.pem",
            # tls_validate_certificate=True,
            # nodelay=True,
        )
    )
    await client.connect()


asyncio.run(main())

Examples

Refer to the examples/python/ directory for usage examples.

Contributing

See CONTRIBUTING.md for contribution guidelines.

License

Licensed under the Apache License 2.0. See LICENSE for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apache_iggy-0.9.0.dev2.tar.gz (543.0 kB view details)

Uploaded Aug 12, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

apache_iggy-0.9.0.dev2-cp313-cp313-musllinux_1_2_x86_64.whl (6.3 MB view details)

Uploaded Aug 12, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

apache_iggy-0.9.0.dev2-cp313-cp313-musllinux_1_2_aarch64.whl (6.1 MB view details)

Uploaded Aug 12, 2026 CPython 3.13musllinux: musl 1.2+ ARM64

apache_iggy-0.9.0.dev2-cp313-cp313-manylinux_2_34_x86_64.whl (5.8 MB view details)

Uploaded Aug 12, 2026 CPython 3.13manylinux: glibc 2.34+ x86-64

apache_iggy-0.9.0.dev2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.0 MB view details)

Uploaded Aug 12, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

apache_iggy-0.9.0.dev2-cp313-cp313-macosx_11_0_arm64.whl (5.2 MB view details)

Uploaded Aug 12, 2026 CPython 3.13macOS 11.0+ ARM64

apache_iggy-0.9.0.dev2-cp313-cp313-macosx_10_12_x86_64.whl (5.4 MB view details)

Uploaded Aug 12, 2026 CPython 3.13macOS 10.12+ x86-64

apache_iggy-0.9.0.dev2-cp312-cp312-musllinux_1_2_x86_64.whl (6.3 MB view details)

Uploaded Aug 12, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

apache_iggy-0.9.0.dev2-cp312-cp312-musllinux_1_2_aarch64.whl (6.1 MB view details)

Uploaded Aug 12, 2026 CPython 3.12musllinux: musl 1.2+ ARM64

apache_iggy-0.9.0.dev2-cp312-cp312-manylinux_2_34_x86_64.whl (5.8 MB view details)

Uploaded Aug 12, 2026 CPython 3.12manylinux: glibc 2.34+ x86-64

apache_iggy-0.9.0.dev2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.0 MB view details)

Uploaded Aug 12, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

apache_iggy-0.9.0.dev2-cp312-cp312-macosx_11_0_arm64.whl (5.2 MB view details)

Uploaded Aug 12, 2026 CPython 3.12macOS 11.0+ ARM64

apache_iggy-0.9.0.dev2-cp312-cp312-macosx_10_12_x86_64.whl (5.4 MB view details)

Uploaded Aug 12, 2026 CPython 3.12macOS 10.12+ x86-64

apache_iggy-0.9.0.dev2-cp311-cp311-musllinux_1_2_x86_64.whl (6.3 MB view details)

Uploaded Aug 12, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

apache_iggy-0.9.0.dev2-cp311-cp311-musllinux_1_2_aarch64.whl (6.1 MB view details)

Uploaded Aug 12, 2026 CPython 3.11musllinux: musl 1.2+ ARM64

apache_iggy-0.9.0.dev2-cp311-cp311-manylinux_2_34_x86_64.whl (5.8 MB view details)

Uploaded Aug 12, 2026 CPython 3.11manylinux: glibc 2.34+ x86-64

apache_iggy-0.9.0.dev2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.0 MB view details)

Uploaded Aug 12, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

apache_iggy-0.9.0.dev2-cp311-cp311-macosx_11_0_arm64.whl (5.2 MB view details)

Uploaded Aug 12, 2026 CPython 3.11macOS 11.0+ ARM64

apache_iggy-0.9.0.dev2-cp311-cp311-macosx_10_12_x86_64.whl (5.4 MB view details)

Uploaded Aug 12, 2026 CPython 3.11macOS 10.12+ x86-64

apache_iggy-0.9.0.dev2-cp310-cp310-musllinux_1_2_x86_64.whl (6.3 MB view details)

Uploaded Aug 12, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

apache_iggy-0.9.0.dev2-cp310-cp310-musllinux_1_2_aarch64.whl (6.1 MB view details)

Uploaded Aug 12, 2026 CPython 3.10musllinux: musl 1.2+ ARM64

apache_iggy-0.9.0.dev2-cp310-cp310-manylinux_2_34_x86_64.whl (5.8 MB view details)

Uploaded Aug 12, 2026 CPython 3.10manylinux: glibc 2.34+ x86-64

apache_iggy-0.9.0.dev2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.0 MB view details)

Uploaded Aug 12, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

apache_iggy-0.9.0.dev2-cp310-cp310-macosx_11_0_arm64.whl (5.2 MB view details)

Uploaded Aug 12, 2026 CPython 3.10macOS 11.0+ ARM64

apache_iggy-0.9.0.dev2-cp310-cp310-macosx_10_12_x86_64.whl (5.4 MB view details)

Uploaded Aug 12, 2026 CPython 3.10macOS 10.12+ x86-64

File details

Details for the file apache_iggy-0.9.0.dev2.tar.gz.

File metadata

Download URL: apache_iggy-0.9.0.dev2.tar.gz
Upload date: Aug 12, 2026
Size: 543.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for apache_iggy-0.9.0.dev2.tar.gz
Algorithm	Hash digest
SHA256	`0ffbaff929f83ff075edbf3fb0f1262769cc38e5712b390c2a832bd25ea8c359`
MD5	`af23fdf259d958c52dbfbf735cafed8d`
BLAKE2b-256	`e68a250edb58fa1e2b8f241bc3b29be7404add0680c359d5c9be5182560339a6`

Algorithm	Hash digest
SHA256	`76dfefdb13c66e8f4203abead7eed882a2fc56671ee7b816a8e3e0bfe90353ad`
MD5	`0e05310625bb884a3d7c923cb40fe8a5`
BLAKE2b-256	`b66cea56aa12760c0edc108e1b4d145b029ec3efdb73d571610f0c41110f8eef`

Algorithm	Hash digest
SHA256	`d2e6f25113fa27246dca7b53132e4762525fc276fc9a76725b63724394f73b04`
MD5	`fd435e427921ad728bc5634c843e0442`
BLAKE2b-256	`4d36130c8a560a614b8b6d77a9f42f0ef6be91e309a4dc891baf799d9137970a`

Algorithm	Hash digest
SHA256	`b201fbd70eba4dbaf38b1f00ee2bc7f9f82aae37c382ac57d4e8df4b404b7cb6`
MD5	`383cca7412737907bcf2191b3f1a0f9c`
BLAKE2b-256	`fdbdc2723af0f6e9e65c2ba178bf9924c3ae3b420962062d65a39744bf408b81`

Algorithm	Hash digest
SHA256	`9d32a86d15f0405fcc1e0cea61c3e48730d84311c23748487efe18132e78fc99`
MD5	`c3f7fbf172ddc4527893dff142164663`
BLAKE2b-256	`316943a5c3bed6c621bd747b5c566dc8df8f21d1cb97cebd1cde1dd24a36f43d`

Algorithm	Hash digest
SHA256	`c15274157ddb1fda188743c2223fcea6f14052cc55444639c97b55787cb13884`
MD5	`b683fa7b42393526dd1f344e8c78c040`
BLAKE2b-256	`fe19860c24a3f5fcfce14b22cfbaf3c3de1f67ed5a5d783dcd0639593cae31c3`

Algorithm	Hash digest
SHA256	`dcd4a028d8de8b4e605819a95f1f3a896a1943f8593e728241f842642a36002c`
MD5	`17cde6b4d3d8793558d6a4ebf10d8f89`
BLAKE2b-256	`62cbd47bac76c3c1e81aa63958d7875d472e4fd56bf4cc83c50f4e56abe9dc6b`

Algorithm	Hash digest
SHA256	`aefb71e0f7356c3eb0c50093da2909220b6d6318b1d3de6a9155d06508f15d45`
MD5	`23ef46017da7358ab23e11a826d613e5`
BLAKE2b-256	`9d03125d23f517f075df9ea048aa1703410040f6ec4b98d12a8c2d1fa5f20b78`

Algorithm	Hash digest
SHA256	`3de73f912dd267f44774fee6e5597a5882d824d7cda46935c11ca5acfd46bda8`
MD5	`f3b65f1bed725546e7dd00530658c4ea`
BLAKE2b-256	`11867210fcccba607c9a4b4b698a780f0b1e24e7a9883ac32bd538e9606f39e8`

Algorithm	Hash digest
SHA256	`ec0b4a29cefce6809cf2f05636b0e004ecd3878194e63c17b9dc4db24d9140ef`
MD5	`86f4c9e6c6f1a30ad55d6feaf00def9d`
BLAKE2b-256	`14fbebc8c233d923821b63d17944aac7e746c6bdc22f5b63f52ca3bfb234f67f`

Algorithm	Hash digest
SHA256	`c6bffa8d3a21fc17d9a5d5757bba09f86a0b366fb11e554fc9b45b7de72c0901`
MD5	`a1c5163c5c1820630a31a06b0f8a9c9b`
BLAKE2b-256	`c78d4d6f1f9b38230b7d3617971e4828343ff0657d68e2e4e89134cda54df781`

Algorithm	Hash digest
SHA256	`b536e9567bd63168a8c12fa9fbdfd074f75934eb21ff69bdf6340e2260308e8e`
MD5	`b85f69a18f4e067d6dc42f241406fef2`
BLAKE2b-256	`39997f45d049c7bdda64f6afb12d0230efda4e8a35ca06169f1bedc177a59cc4`

Algorithm	Hash digest
SHA256	`e17826cf09230618fef9d8c68494d87f8d7f8a02510d66e92c50f7c134197c7a`
MD5	`d2cd7f3fdcfb938b5f56aadc350e7caf`
BLAKE2b-256	`9ab880673a0eabbf1387670cc8fd6bed96384cf7b17477e477c81fe38b4b79b2`

Algorithm	Hash digest
SHA256	`b11bf3fffa8f585dd9f7cf5a466691ccf029a7321ad94e21e50fc01a68954829`
MD5	`307c8ddd9b388440af5ac777551f2c4a`
BLAKE2b-256	`0d456746aa0cf50f74d3fa42c62b88fb3d4d0095abaa317870c5c5767f6190a4`

Algorithm	Hash digest
SHA256	`045d73cfcc096e6241393513f27fde1015679de4f083af6792f364cbdf5b2aca`
MD5	`82b153648644296569432f0edb1aba4a`
BLAKE2b-256	`8e2bdff4cb89ec92f80b7a9ee6697bc601c94c7714941f781f2ae4b841aca8c2`

Algorithm	Hash digest
SHA256	`70d12e181eabaa68aa2f98f9f8db295fadc1170eb56d2ea94430bf1c938b9df6`
MD5	`eb7f972db15350d7a6859880de1a5962`
BLAKE2b-256	`8e3bfd1ba282588410f64447e5285cdd129b3ce6ad7d0a2586273dce7f2e969a`

Algorithm	Hash digest
SHA256	`92e9d1ac2e6a52ba3e02195f3be95f8c19ea4a370abc0a1c44cf93da2a95ab38`
MD5	`f4e733d4c731c2315880c737ac00bc8a`
BLAKE2b-256	`7908d0aaf726e5b2377d3f5511fb0fa0000f35e6a52462b4fd79239e20f983c9`

Algorithm	Hash digest
SHA256	`f58ba8eac603c16b1c0073d1fff0e123959de70ba6802f52bcc7e8d5a6c341ee`
MD5	`6bef2f2b4eb0a7947d3c153cf23c0a4e`
BLAKE2b-256	`8f975790e933b744cdcb004c4863b289324f81faf12427536d16630fa1f9d889`

Algorithm	Hash digest
SHA256	`c12b191685508e75e0da895762d6ca9cc365f2ca35531df44ade346b05a94a59`
MD5	`11fc2c897c02f6b73344f398f4cc45e9`
BLAKE2b-256	`78ce836a6120f1c16db0910a903d3f94edf7e66af36b4ea6e11d588964222abe`

Algorithm	Hash digest
SHA256	`a104eee29bb9d4256d454cce8558d3d5ee29ede8dac0cb1adba98eeccb6a73c7`
MD5	`56183e4cb7483ba2dfae60ece67d9596`
BLAKE2b-256	`82ea8379183d520ac52c2b071a40943ecb100de351269e9854de4a02f28e6142`

Algorithm	Hash digest
SHA256	`0e19f1cfae4191f4146776d30154e8cecea6c3675e384b7a6c0d6707eed34172`
MD5	`f984566b00ba6641c557e572eb31fe7b`
BLAKE2b-256	`8919924a93db41fe7878cdadbacd6b3926d49704aacd0dd599804c3b419f6811`

apache-iggy 0.9.0.dev2

apache-iggy

Installation

Basic Installation

Prerequisites

Local Development

Client Configuration

Examples

Contributing

License

Project links

Key dates

6 maintainers

Credits

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Algorithm	Hash digest
SHA256	`c789274d48817c4b04a9fd8924ae819f3736b0c6c8a1cb3edef7ce4f79959640`
MD5	`79c548731868aa50012c770c7f904524`
BLAKE2b-256	`4a9b0f1f2ce801239530602f63ed0d752b3ed7e9d70cd2f03c60097fa237e922`

Algorithm	Hash digest
SHA256	`232a72ac4a5061db60786bfff9179d759577ae635e9d19709b0902a6ae8fe2c7`
MD5	`b5b107112304cbb91d0e2c67715a5213`
BLAKE2b-256	`75eb2af2ea9058a0b5a16e015f10a0798746977277994c03321a2f4fe22039f8`

Algorithm	Hash digest
SHA256	`508217edd78ead031cfe46f70161554988cc015eb9371a5eee3c5de683c7bae6`
MD5	`778538ce2679579059804cf793d402e8`
BLAKE2b-256	`70d923921b71428631921352fcd2d4361d8dd02edc29eb4e10004c8f6b1a061f`

Algorithm	Hash digest
SHA256	`0837b26a50cd086ddb48e5a201cc41ac6109fc4115f45d944640b19e50282fc6`
MD5	`ec687133c883b0e7e87c5f8ada92c6be`
BLAKE2b-256	`d975e0e9cfe5d23f32c8676c329b546a0a1f37b50cda8658c7cc33f70224ead4`