---
id: types-confluent-kafka
version: "1.4.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-confluent-kafka — Types for Confluent Kafka

License: permissive · Maintenance: active · Downloads: 1.7M/mo

## 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 above — 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

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

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

## Tags

confluent kafka type hints, mypy stubs for kafka, confluent-kafka typing support, kafka python type checking, confluent kafka autocomplete, python kafka type stubs, confluent-kafka lsp completion, type-stubs, mypy-compatible

[View on SkillFed](https://skillfed.io/packages/types-confluent-kafka) · [View on PyPI](https://pypi.org/project/types-confluent-kafka/)