NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #890 most downloaded on PyPI
Pure Python client for Apache Kafka
Latest stable
3.0.13
Last release 10 days ago
06 Nov 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
84 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Use non-deprecated exception handling (jeffwidman a699f6a)
This is a substantial release. Although there are no known 'showstopper' bugs as of release, we do recommend you test any planned upgrade to your application prior to running in production.
Some of the major changes include:
Thanks to all contributors -- the state of the kafka-python community is strong!
Detailed changelog are listed below:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix partition assignment race condition (jeffwidman #1240)
Avoid multiple connection attempts when refreshing metadata (dpkp #1067)
Derive all api classes from Request / Response base classes (dpkp 1030)
Core / Protocol
max_bytes option and FetchRequest_v3 usage. (Drizzt1991 962)Test Infrastructure
Consumer
Producer
Client
Bugfixes
Logging / Error Messages
Documentation
Legacy Client
Add kafka.serializer interfaces (dpkp 912)
Core
Consumer
Producer
Client
Bugfixes
Logging / Error Messages
Documentation
max_poll_records option (Drizzt1991 881)Fix AttributeError in BrokerConnectionMetrics after reconnecting
Bugfixes
Change api_version config to tuple; deprecate str with warning (dpkp 761)
Fix bug causing KafkaProducer to double-compress message batches on retry
Update consumer_timeout_ms docstring - KafkaConsumer raises StopIteration, no longer ConsumerTimeout
Fix gc error log: avoid AttributeError in _unregister_cleanup (dpkp PR 747)
Clarify timeout unit in KafkaProducer close and flush (ms7s PR 734)
Fix regression in MessageSet decoding wrt PartialMessages
Add protocol support for ApiVersionRequest (dpkp PR 678)
fix throttle_time_ms sensor handling (zackdever pr 667)
Avoid resending FetchRequests that are pending on internal queue
This release includes critical bugfixes -- upgrade strongly recommended
This release includes critical bugfixes -- upgrade strongly recommended
Add RangePartitionAssignor (and use as default); add assignor tests (dpkp PR 550)
__del__ if we failed assertions__del__ (aisch PR 554)SimpleConsumer and MultiProcessConsumer are now deprecated and will be removed in a future release. Users are encouraged to migrate to KafkaConsumer.
This release includes significant code changes. Users of older kafka-python versions are encouraged to test upgrades before deploying to production as some interfaces and configuration options have changed.
Users of SimpleConsumer / SimpleProducer / SimpleClient (formerly KafkaClient) from prior releases should migrate to KafkaConsumer / KafkaProducer. Low-level APIs (Simple*) are no longer being actively maintained and will be removed in a future release.
For comprehensive API documentation, please see python help() / docstrings, kafka-python.readthedocs.org, or run tox -e docs from source to build documentation locally.
Consumers
Producers
Clients
Documentation
Internals
Initial support for consumer coordinator: offsets only (toddpalino PR 420)
Consumers
Producers
Clients
Documentation
Internals
Deprecate metadata_broker_list in favor of bootstrap_servers in KafkaConsumer (dpkp #340)
Consumers
Producers
__del__ (chmduquesne #324)KafkaClient
Documentation
Internals
__version__ at runtime (dpkp #387)Add coveralls.io support (sontek PR 307)
Warn users that async producer does not reliably handle failures (dpkp - PR 213)
Add codec parameter to Producers to enable compression (patricklucas - https://github.com/mumrah/kafka-python/pull/166)
Connection refactor and test fixes (wizzat - https://github.com/mumrah/kafka-python/pull/134)
One column per quarter.