Skip to content



cz init --help


To start using commitizen, the recommended approach is to run

cz init


This command will ask you for information about the project and will configure the selected file type (pyproject.toml, .cz.toml, etc.).

The init will help you with

  1. Choose a convention rules (name)
  2. Choosing a version provider (commitizen or for example Cargo.toml)
  3. Detecting your project's version
  4. Detecting the tag format used
  5. Choosing a version type (semver or pep440)
  6. Whether to create the changelog automatically or not during bump
  7. Whether you want to keep the major as zero while building alpha software.
  8. Whether to setup pre-commit hooks.