A privacy-first CLI tool that generates intelligent Git commit message suggestions using local LLM (Ollama), supporting conventional commit formats without external API costs.

Features

Generate intelligent commit message suggestions from staged changes
Support for Conventional Commits format
Multi-language analysis
Privacy-first (no external APIs, runs entirely locally)
Customizable prompts and configurations
Context-aware suggestions using commit history

Installation

pip install git-commit-ai

Quick Start

Ensure Ollama is installed and running
Pull a model (recommended: qwen2.5-coder:3b):
```
ollama pull qwen2.5-coder:3b
```
Stage your changes:
```
git add .
```
Generate a commit message:
```
git-commit-ai generate
```

Usage

Basic Usage

git-commit-ai generate

With Conventional Commits

git-commit-ai generate --conventional

Specify Model

git-commit-ai generate --model llama3.2

Configuration

Create a .git-commit-ai/config.yaml file in your repository:

model: qwen2.5-coder:3b
base_url: http://localhost:11434
conventional: true
max_length: 80

Troubleshooting

Ensure Ollama is running: ollama list
Check model is available: ollama pull <model>
Verify git repository has staged changes