gitstats 1.6.1

GitStats - Visualize Your Git Repositories

$ gitstats

📊 Generate insightful visual reports from Git.

📘 Documentation: gitstats.readthedocs.io

Example

gitstats . report generates this gitstats report.

Installation

pip install gitstats

gitstats is compatible with Python 3.9 and newer.

Usage

gitstats <gitpath> <outputpath>

Run gitstats --help for more options, or check the documentation.

Features

Here is a list of some features of gitstats:

• General: total files, lines, commits, authors, age.

• Activity: commits by hour of day, day of week, hour of week, month of year, year and month, and year.

• Authors: list of authors (name, commits (%), first commit date, last commit date, age), author of month, author of year.

• Files: file count by date, extensions.

• Lines: line of code by date.

• Tags: tags by date and author.

• Customizable: config values through gitstats.conf.

• Cross-platform: works on Linux, Windows, and macOS.

AI-Powered Features 🤖

GitStats supports AI-powered insights to enhance your repository analysis with natural language summaries and actionable recommendations.

Quick Start:

# Install with AI support
pip install gitstats[ai]

# Enable AI with OpenAI
export OPENAI_API_KEY=your-api-key
gitstats --ai --ai-provider openai <gitpath> <outputpath>

For detailed setup instructions, configuration options, and examples, see the AI Integration Documentation.

Contributing

As an open source project, gitstats welcomes contributions of all forms.

---

The gitstats project was originally created by Heikki Hokkainen and is currently maintained by Xianpeng Shen.