---
id: gitchangelog
version: "3.0.4"
license: BSD 3-Clause License
license_treatment: permissive
maintenance: abandoned
---

# gitchangelog — gitchangelog generates a changelog thanks to git log.

License: permissive · Maintenance: abandoned · Downloads: 92.8K/mo

## What it is and what it does

gitchangelog reads your git commit history and generates a formatted changelog by parsing commit messages according to rules you define in a configuration file. It classifies commits into sections (New, Fix, Changes, etc.), filters by regex patterns, and renders output using your choice of template engine or built-in formats. The tool supports both incremental and full changelog generation, handles merge/rebase workflows, and can extract structured data from commit trailers like Co-Authored-By.

The package installs as a command-line tool with no runtime dependencies, making it lightweight to deploy. It comes with example templates and a reference configuration file to get started quickly. You can also use it as a standalone executable without installing the full package, though the standalone mode requires you to provide all configuration values explicitly.

Use it for:

- Generate release notes automatically from git commits for each version tag
- Classify and organize commits into semantic sections for better changelog readability
- Create changelogs in multiple formats (ReStructuredText, HTML, Markdown) from the same commit history
- Filter out internal or development commits from user-facing changelogs using regex rules
- Maintain incremental changelogs for continuous integration workflows without regenerating the entire history

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates a formatted changelog from git commit history, filtering and classifying commits according to configurable rules and templates.

Yes, if you need a lightweight, zero-dependency changelog generator and can tolerate that the project is no longer maintained. The tool is stable and works for straightforward use cases, but do not expect fixes for edge cases or compatibility issues with very recent git or Python versions. Consider it suitable for established projects with stable workflows, not for bleeding-edge setups.

## Install

pip install gitchangelog
uv add gitchangelog
poetry add gitchangelog

## Installing gitchangelog

Before you install: Low install friction with no runtime dependencies. However, the project is abandoned as of 2022 with no updates for nearly 3 years, so expect no bug fixes or maintenance.

License in practice: BSD 3-Clause License is permissive and poses no restrictions on use, modification, or redistribution in proprietary or open-source contexts.

Quickstart:

pip install gitchangelog

# In your git repository root, create .gitchangelog.rc with your config,
# then run:
gitchangelog > CHANGELOG.rst

Requires git to be installed and accessible in PATH; the repository must have at least one commit and ideally git tags for version markers.

Verify before relying:

- Whether the tool still works reliably with modern git versions and Python 3.7+
- Current state of Windows compatibility mentioned as incomplete in the description
- Whether template engines (mako, mustache) are optional or required

## Package facts

- License: BSD 3-Clause License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 92.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

changelog from git log, automated changelog generation, commit history formatter, git changelog tool, release notes from commits, git log to changelog, configurable changelog builder, git-automation, release-management

[View on SkillFed](https://skillfed.io/packages/gitchangelog) · [View on PyPI](https://pypi.org/project/gitchangelog/)