---
id: smithy-aws-event-stream
version: "0.3.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# smithy-aws-event-stream — Smithy components for Amazon Event Streams.

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

## What it is and what it does

This package provides low-level Python components for handling Amazon Event Streams as part of the Smithy SDK generation framework. It is designed to be used as a runtime dependency in service clients generated by the Smithy Python code generator, enabling asynchronous communication over event streams using the restJson1 protocol.

The package is currently in pre-alpha development and explicitly warns that all interfaces are subject to change. It depends only on smithy-core and supports Python 3.12 and newer. It is not intended for production use yet, and several features remain unimplemented. Developers should treat this as an unstable, experimental component that may undergo breaking changes.

Use it for:

- Building Smithy-generated Python clients that need to handle AWS event stream operations.
- Integrating event stream communication into asynchronous service clients for non-AWS Smithy services.
- Prototyping or testing event stream protocols before production deployment.

## Worth the install?

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

Provides low-level Python components for handling Amazon Event Streams within Smithy-generated service clients, enabling asynchronous event stream communication.

No, not for production. This package is explicitly pre-alpha with unstable interfaces and a warning against production use. Install only if you are generating Smithy clients that require event stream support and are willing to accept breaking changes as the package matures.

## Install

pip install smithy-aws-event-stream
uv add smithy-aws-event-stream
poetry add smithy-aws-event-stream

## Installing smithy-aws-event-stream

Before you install: Low install friction with a single pure-Python dependency (smithy-core). Active maintenance with recent commits, though the package remains in pre-alpha status and explicitly warns that all interfaces are subject to change.

License in practice: Licensed under Apache License 2.0 (permissive), allowing use in proprietary and open-source projects with minimal restrictions beyond attribution.

Quickstart:

pip install smithy-aws-event-stream

from smithy_aws_event_stream import EventStreamCodec
# Use within a Smithy-generated client that handles event streams

Requires Python 3.12 or newer; intended for use as a dependency within Smithy-generated clients, not as a standalone library.

Verify before relying:

- What specific event stream operations or protocols this package implements beyond the generic 'Amazon Event Streams' description.
- Whether this package can be used independently or only as part of a Smithy code-generated client.
- Performance characteristics or throughput limits for event stream handling.

## Package facts

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

## Tags

event stream handling python, aws event stream sdk, smithy event stream components, async event stream client, amazon eventstream protocol, smithy-sdk, event-stream, pre-alpha

[View on SkillFed](https://skillfed.io/packages/smithy-aws-event-stream) · [View on PyPI](https://pypi.org/project/smithy-aws-event-stream/)