How to Programmatically Create a Topic in Apache Kafka Using Python

Apache Kafka has become a cornerstone in the architecture of many data-driven applications, offering robust capabilities for managing real-time data streams. It's a distributed event store and stream-processing platform designed to handle high volumes of data efficiently. For developers working with Kafka, one common task is creating topics where messages are published and subscribed to. While this can be done manually via command-line interfaces, automating this process programmatically can significantly streamline workflows, especially in dynamic environments where topics need to be created on the fly. In this post, we'll explore how to programmatically create a topic in Apache Kafka using Python, a popular programming language known for its simplicity and versatility.


Before diving into the code, ensure you have the following:

  • Apache Kafka and Zookeeper installed and running on your system.
  • Python installed on your system.
  • The kafka-python library installed. You can install it using pip:
pip install kafka-python

This library provides many Kafka functionalities, including the ability to create topics programmatically.

Creating a Topic in Kafka with Python

To create a Kafka topic programmatically with Python, follow these steps:

1. Import the KafkaAdminClient

First, import the KafkaAdminClient from the kafka.admin module. This client provides administrative APIs to manage Kafka topics, brokers, configurations, and more.

from kafka.admin import KafkaAdminClient, NewTopic

2. Initialize the KafkaAdminClient

Create an instance of the KafkaAdminClient. You need to specify the Kafka server's address and port in the bootstrap_servers parameter. Replace 'localhost:9092' with your Kafka server's actual address and port.

admin_client = KafkaAdminClient(

3. Define the Topic Configuration

Define the new topic's configuration by creating an instance of NewTopic. Here, you specify the topic name, the number of partitions, and the replication factor. The partitions determine how the topic's data is distributed, while the replication factor specifies the number of copies of the topic data.

topic_list = [NewTopic(name="MyNewTopic", num_partitions=3, replication_factor=1)]

Adjust the name, num_partitions, and replication_factor according to your requirements.

4. Create the Topic

Now, use the create_topics method of the KafkaAdminClient to create the topic. Pass the topic configuration you defined in the previous step.

admin_client.create_topics(new_topics=topic_list, validate_only=False)

The validate_only parameter, when set to False, means the topic will be created immediately. If set to True, it will only validate if the topic can be created but won't actually create it.


Creating a topic in Apache Kafka programmatically using Python is straightforward with the kafka-python library. This approach is particularly useful in automated systems and applications where topics need to be created dynamically. By following the steps outlined above, developers can integrate Kafka topic creation into their Python applications, enhancing their data management and processing capabilities.

Remember to adjust the configurations like the number of partitions and replication factor based on your specific requirements and Kafka cluster setup. Happy coding!