types-confluent-kafka

What it is and what it does

types-confluent-kafka is a type-stub package that provides static type information for the confluent-kafka library. It allows developers using mypy or other type checkers to catch type errors at development time, and enables IDE language servers to provide accurate autocompletion and inline documentation. The package is community-maintained (not officially endorsed by Confluent) and designed for users on confluent-kafka versions prior to 2.13.0, when the library added its own built-in type hints. Since it contains only stub files and metadata, it has zero runtime dependencies and installs with minimal friction.

The package follows semantic versioning and is actively maintained with frequent releases to track API changes. It supports Python 3.9 through 3.14. Users on confluent-kafka 2.13.0 or later should use the official type hints instead.

Use it for:

• Add type checking to a confluent-kafka application running on versions below 2.13.0.
• Enable IDE autocompletion and inline documentation for confluent-kafka APIs in mypy-enabled projects.
• Migrate a legacy codebase to static typing without upgrading the confluent-kafka dependency immediately.
• Catch configuration and API misuse errors at development time in Kafka client code.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type hints and stub files for the confluent-kafka package to enable static type checking with mypy and IDE autocompletion.

Yes, if you are using confluent-kafka below version 2.13.0 and want type checking and IDE support. No, if you are already on confluent-kafka 2.13.0 or later—use the official type hints instead. The package is actively maintained, has no runtime overhead, and carries a permissive license, making it a low-risk addition for teams that need it.

Install

types-confluent-kafka on PyPI

pip install types-confluent-kafka

uv add types-confluent-kafka

poetry add types-confluent-kafka

Installing types-confluent-kafka

Before you install

Low friction install with no runtime dependencies. Actively maintained with recent commits as of 2026-04-11, though intended primarily for confluent-kafka versions below 2.13.0.

License in practice

Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install types-confluent-kafka

# Type checking now works with your confluent-kafka code
# mypy will validate your usage patterns

Intended for confluent-kafka versions below 2.13.0; confluent-kafka 2.13.0+ includes official type hints.

Verify before relying

• Exact coverage of confluent-kafka API surface across different versions—compatibility table referenced but not detailed.
• Whether type hints remain accurate relative to confluent-kafka's evolution post-2.13.0.
• How to use this package in practice with confluent-kafka as a peer dependency.

Package facts

Evidence: types_confluent_kafka-1.4.1-py3-none-any.whl

Keywords: types, typings, stubs, confluent_kafka, mypy, lsp, completion, type hints, type checking

Tags

More Software Development packages