Build an AI Changelog Generator in Python

Writing changelogs is one of those developer tasks that sounds simple until you are staring at a messy commit history.

Some commits matter to users. Some are internal cleanup. Some are merge commits. Some are meaningful only if you already know the codebase. I built a small Python example that turns commit messages or git diffs into structured changelog JSON using Telnyx AI Inference.

Code: https://github.com/team-telnyx/telnyx-code-examples/tree/main/changelog-generator-python

What it does

The Flask app exposes:

POST /generate

POST /generate/from-diff

GET /changelogs

GET /changelogs/<id>

GET /health

POST /generate accepts a list of commit messages:

{

  "version": "v1.4.0",

  "repo_name": "billing-service",

  "commits": [

    "feat: add Stripe webhook retry with exponential backoff",

    "fix: correct tax calculation for EU VAT exemption",

    "docs: update API reference for invoice endpoint"

  ]

}

The app asks Telnyx AI Inference to return grouped changelog JSON with sections like:

• Features


• Bug Fixes


• Improvements


• Breaking Changes


• Documentation


• Other

There is also a POST /generate/from-diff endpoint if you want to summarize a git diff instead of commit messages.

Why structured output matters

For a changelog tool, plain text is useful, but structured output is more flexible.

If the response comes back as JSON, you can:

• render it in a docs site


• save it in a release database


• post it into a PR comment


• send it to Slack


• open a release-note review workflow


• let a human approve it before publishing

The example stores generated changelogs in memory and gives each one an ID, so you can list recent changelogs or retrieve a specific one.

Run it

Clone the examples repo:

git clone https://github.com/team-telnyx/telnyx-code-examples.git

cd telnyx-code-examples/changelog-generator-python

Create your .env file:

cp .env.example .env

Add your Telnyx API key:

TELNYX_API_KEY=your_telnyx_api_key

AI_MODEL=moonshotai/Kimi-K2.6

HOST=127.0.0.1

Install and run:

pip install -r requirements.txt

python app.py

Try it:

curl -X POST http://localhost:5000/generate \

  -H "Content-Type: application/json" \

  -d '{

    "version": "v1.4.0",

    "repo_name": "billing-service",

    "commits": [

      "feat: add Stripe webhook retry with exponential backoff",

      "fix: correct tax calculation for EU VAT exemption",

      "docs: update API reference for invoice endpoint"

    ]

  }' | python3 -m json.tool

Where this could go

This is a small example, but it is a pretty practical developer tooling pattern:

• generate draft release notes from merged PRs


• summarize changes between two tags


• create changelog drafts during CI


• generate per-SDK release notes


• publish to docs after human approval

The Telnyx code examples repo is also agent-readable, so you can use this example as a starting point and ask a coding agent to add GitHub integration, tag comparison, a UI, or a docs publishing step.

Resources

• Telnyx AI skills and toolkits: https://github.com/team-telnyx/ai
  


• Telnyx AI Inference docs: https://developers.telnyx.com/docs/inference