📖 zero deps · zero API keys · one command

gitstory

Turn any git repo's history into a narrative changelog. The story is already in the log — gitstory just tells it, in three voices.

★ GitHub Install Examples

Install & run

$ pip install -e git://github.com/neelrajdev/gitstory#egg=gitstory # from source (PyPI soon)
$ git clone https://github.com/neelrajdev/gitstory && cd gitstory
$ pip install -e .
$ gitstory . --tone roast

The three tones — real output

All examples below are genuine gitstory output, run on a real repo (crash-report-portfolio).

professional

…release-notes voice: totals, dates, pace, highlights…

fun

…movie-trailer voice…

roast

…honesty, weaponized…

How it works

1 · Collect

Reads your real git log — commit taxonomy, pace, authors, 12-week activity buckets. No repo data leaves your machine.

2 · Narrate

A deterministic template engine writes the story. Zero API keys, zero network, works offline.

3 · Enhance (optional)

Point it at any OpenAI-compatible API (Gemini, Groq, Ollama, OpenAI) and the prose levels up. Any failure → graceful fallback.