<img src="./assets/jikkou-logo-title.png" alt="Jikkou Logo" width="400"/> <h3 align="center">Resource as Code for Apache Kafka</h3> Declare. Apply. Automate. Manage your Kafka resources the same way you manage your infrastructure. <a href="https://github.com/streamthoughts/jikkou/actions/workflows/maven-build.yml"><img src="https://github.com/streamthoughts/jikkou/actions/workflows/maven-build.yml/badge.svg" alt="Build Status"/></a> <a href="https://github.com/streamthoughts/jikkou/blob/main/LICENSE"><img src="https://img.shields.io/github/license/streamthoughts/jikkou" alt="License"/></a> <a href="https://github.com/streamthoughts/jikkou/releases"><img src="https://img.shields.io/github/v/release/streamthoughts/jikkou?color=blue&label=latest" alt="Release"/></a> <a href="https://github.com/streamthoughts/jikkou/stargazers"><img src="https://img.shields.io/github/stars/streamthoughts/jikkou?style=flat" alt="Stars"/></a> <a href="https://sonarcloud.io/dashboard?id=streamthoughts_jikkou"><img src="https://sonarcloud.io/api/project_badges/measure?project=streamthoughts_jikkou&metric=reliability_rating" alt="Reliability"/></a> <a href="https://sonarcloud.io/dashboard?id=streamthoughts_jikkou"><img src="https://sonarcloud.io/api/project_badges/measure?project=streamthoughts_jikkou&metric=sqale_rating" alt="Maintainability"/></a> <a href="https://sonarcloud.io/dashboard?id=streamthoughts_jikkou"><img src="https://sonarcloud.io/api/project_badges/measure?project=streamthoughts_jikkou&metric=coverage" alt="Coverage"/></a> <a href="https://jikkou.io/">Documentation</a> • <a href="https://jikkou.io/docs/install/">Install</a> • <a href="https://jikkou.io/docs/tutorials/">Tutorials</a> • <a href="https://join.slack.com/t/jikkou-io/shared_invite/zt-27c0pt61j-F10NN7d7ZEppQeMMyvy3VA">Slack</a>

Jikkou (jikkou / 実行 — execution in Japanese) is an open-source tool that lets you manage Apache Kafka resources declaratively using YAML files, the same way kubectl manages Kubernetes resources.

Stop writing scripts. Stop clicking through UIs. Define your desired state, and Jikkou makes it happen.

Why Jikkou?

| | | |---|---| | Declarative | Define Topics, ACLs, Schemas, Connectors, and Quotas as code in simple YAML files | | GitOps-Ready | Version-control your Kafka configuration and automate changes through CI/CD | | Stateless | No database needed — Jikkou uses your Kafka platform as the source of truth | | Safe | Built-in dry-run mode, validations, and reconciliation engine prevent accidents | | Extensible | Plugin-based architecture with providers, validators, transformations, and templates | | Multi-Platform | Works with Apache Kafka, Confluent Cloud, Aiven, Amazon MSK, Redpanda, and more |

Quick Start

Install

# Via SDKMan (recommended)
sdk install jikkou

# Or via Docker
docker pull streamthoughts/jikkou

See the full installation guide for native binaries, Homebrew, and more.

Define a Kafka topic

# kafka-topics.yaml
apiVersion: 'kafka.jikkou.io/v1beta2'
kind: 'KafkaTopic'
metadata:
  name: 'my-topic'
spec:
  partitions: 12
  replicas: 3
  configs:
    min.insync.replicas: 2

Apply it

jikkou apply --files ./kafka-topics.yaml

That's it. Jikkou computes the diff and applies only the necessary changes:

TASK [CREATE] Create a new topic my-topic (partitions=12, replicas=3) - CHANGED
EXECUTION in 2s 661ms
ok: 0, created: 1, altered: 0, deleted: 0, failed: 0

Supported Resources

How It Works

Jikkou follows a simple reconciliation loop:

Read your resource definitions from YAML files (with Jinja templating support)
Compute the differences between desired state and actual cluster state
Apply only the minimal set of changes needed
Report what was created, updated, or deleted

Deployment Modes

| Mode | Description | |-------------------|-----------------------------------------------------------------------------------------------| | CLI | Run as a command-line tool — perfect for local development and CI/CD pipelines | | API Server | Run as a REST API server — ideal for platform teams and automation | | Docker | Available as container images on Docker Hub | | Native Binary | GraalVM-compiled native executables for instant startup |

Documentation

Full documentation is available at jikkou.io.

Developers

For build instructions, development setup, and contribution guidelines, see:

CONTRIBUTING.md — How to contribute, coding guidelines, commit conventions
AGENTS.md — Detailed development guidelines, build commands, and architecture

Quick Build

# Build and run all tests
./mvnw clean verify

# Build without tests
./mvnw clean verify -DskipTests

# Apply code formatting
./mvnw spotless:apply

Requirements: Java 25, Docker (for integration tests), GraalVM (for native builds)

Contributors

Jikkou is built by its community. Thank you to everyone who has contributed!

<a href="https://github.com/streamthoughts/jikkou/graphs/contributors"> <img src="https://contrib.rocks/image?repo=streamthoughts/jikkou&max=100&columns=12" alt="Contributors"/> </a>

Want to see your name here? Check out the contribution guide and open issues.

Support the Project

If you find Jikkou useful, please consider:

Giving it a star on GitHub to help others discover it
Joining the Slack community to ask questions and share feedback
Contributing code, documentation, or bug reports

License

Licensed under the Apache License, Version 2.0.

Developed with ❤ by <a href="https://github.com/fhussonnois">Florian Hussonnois</a> and the Jikkou community.

Jikkou

Install / Use

README