---
id: azure-eventhub-checkpointstoreblob-aio
version: "1.2.0"
license: MIT License
license_treatment: permissive
maintenance: active
---

# azure-eventhub-checkpointstoreblob-aio — Microsoft Azure Event Hubs checkpointer implementation with Blob Storage Client Library for Python

License: permissive · Maintenance: active · Downloads: 730.6K/mo

## What it is and what it does

This package integrates Azure Blob Storage as a checkpoint store for async Event Hubs consumers. When processing events from Azure Event Hubs, consumers need to track their position (offset) within each partition so they can resume from the correct location after a restart or failover. This package provides the BlobCheckpointStore class, which persists that state in Azure Blob Storage blobs, allowing multiple consumer instances to coordinate partition ownership and maintain event stream position across restarts.

The package is designed as a plug-in for EventHubConsumerClient and handles the mechanics of storing and retrieving checkpoint data asynchronously. It depends on azure-eventhub for the consumer client interface and aiohttp for async HTTP operations. It is the async-only variant; a synchronous version exists separately.

Use it for:

- Distributed event processing where multiple consumer instances need to coordinate partition assignment and resume from the last processed offset after restarts.
- Building resilient event pipelines that can survive consumer failures without losing or replaying large event batches.
- Implementing event stream replay by resetting checkpoints to earlier offsets when reprocessing is needed.
- Auditing and compliance scenarios where you need persistent records of which events have been processed by which consumer groups.
- Multi-region or multi-instance deployments where checkpoint state must be shared across consumer instances via a durable store.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Stores checkpoints and partition ownership for Azure Event Hubs consumers using Azure Blob Storage as the persistent backend, enabling async event processing with automatic failover and replay capability.

Yes. This is a stable, actively maintained package from Microsoft's official Azure SDK with no known vulnerabilities, low install friction, and a permissive MIT license. Install it if you are building an async Event Hubs consumer application and need reliable checkpoint persistence—it is the standard way to do so on Azure.

## Install

pip install azure-eventhub-checkpointstoreblob-aio
uv add azure-eventhub-checkpointstoreblob-aio
poetry add azure-eventhub-checkpointstoreblob-aio

## Installing azure-eventhub-checkpointstoreblob-aio

Before you install: Low friction install with six runtime dependencies, all from the Azure SDK ecosystem. Actively maintained with recent releases; the repo is current and has substantial community engagement.

License in practice: MIT License permits commercial and private use with minimal restrictions—you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart:

pip install azure-eventhub-checkpointstoreblob-aio

from azure.eventhub.aio import EventHubConsumerClient
from azure.eventhub.extensions.checkpointstoreblobaio import BlobCheckpointStore

checkpoint_store = BlobCheckpointStore.from_connection_string(
    storage_connection_str, container_name
)
client = EventHubConsumerClient.from_connection_string(
    connection_str, consumer_group,
    eventhub_name=eventhub_name,
    checkpoint_store=checkpoint_store
)

Requires Python 3.8 or later; requires active Azure Event Hubs namespace, Event Hub, and Azure Storage Blob container with appropriate connection strings.

Verify before relying:

- Performance characteristics when checkpointing at scale (e.g., throughput, latency impact per partition).
- Behavior and recovery time when storage connectivity is temporarily lost during event processing.
- Whether the package supports custom storage API versions beyond the default 2019-07-07.

## Package facts

- License: MIT License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 730.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure event hubs checkpoint store, event hubs consumer checkpointing, blob storage checkpoint management, azure eventhub async consumer, distributed event processing state, partition offset tracking azure, event stream replay and failover, azure-sdk, async-io, event-streaming

[View on SkillFed](https://skillfed.io/packages/azure-eventhub-checkpointstoreblob-aio) · [View on PyPI](https://pypi.org/project/azure-eventhub-checkpointstoreblob-aio/)