komit 0.1.5

AI-powered git commit message generator using local LLMs

🤖 komit

AI-powered git commit message generator using local LLMs via Ollama. No API keys, no internet required — runs completely locally and privately.

---

---

Features

• 🧠 Local LLM — uses Ollama, no API keys needed
• 📝 Multiple commit styles — conventional, simple, detailed
• 🔄 Regenerate — not happy? generate a new message instantly
• ✏️ Edit before commit — open your editor to tweak the message
• ⚙️ CLI flags — control style, model, and more from the command line
• 🌍 Universal — works via pip, binary, or shell script
• ⚡ Fast — runs on your machine, no network calls to external APIs

---

Requirements

• Ollama installed and running
• A local model pulled (e.g. ollama pull qwen2.5:7b)

---

Installation

Option 1 — One line install (no Python required)

curl -fsSL https://raw.githubusercontent.com/glemiu6/komit/master/scripts/install.sh | bash

Option 2 — pip

pip install komit

Option 3 — pipx (recommended for CLI tools)

pipx install komit

Option 4 — Download binary

Download the binary for your platform from GitHub Releases:

Platform	Binary
Linux x86_64	komit-linux-x86_64
macOS Apple Silicon	komit-macos-arm64
Windows	komit-windows-x86_64.exe

Intel Mac users: use pip install komit instead.

# Linux/Mac
chmod +x komit-*
sudo mv komit-* /usr/local/bin/komit

---

Setup

Git alias (recommended)

git config --global alias.ai '!komit'

Now you can use git ai as a shortcut.

---

Usage

# Stage your changes
git add .

# Generate commit message
komit

# Or via git alias
git ai

# Or via shell script
./scripts/commit.sh

CLI flags

komit [--style STYLE] [--model MODEL] [--ollama-url URL] [--max-diff N]

Flag	Options	Default	Description
-s, --style	conventional, simple, detailed	conventional	Commit message style
-m, --model	any Ollama model	qwen2.5:7b	Model to use
-u, --ollama-url	any URL	http://localhost:11434	Ollama server URL
--max-diff	integer	4000	Max diff length sent to model

Examples

# Use simple style
komit --style simple

# Use a faster model
komit --model llama3.2:3b

# Use detailed style with a different model
komit --style detailed --model mistral:7b

# Connect to a remote Ollama instance
komit --ollama-url http://192.168.1.10:11434

# Limit diff size for large changesets
komit --max-diff 2000

Interactive prompt

Staged files (3):
  - src/auth.py
  - tests/test_auth.py
  - README.md

Generating commit message... (style: conventional, model: qwen2.5:7b)

Suggested message:
  feat: add JWT authentication with refresh token support

Use this message? (y/n/e to edit/r to regenerate):

Key	Action
y	Commit with the suggested message
n	Cancel
e	Open editor to modify the message
r	Regenerate a new message

---

Commit Styles

Conventional (default)

feat: add user authentication
fix: resolve null pointer in login flow
docs: update API reference

Simple

Add user authentication
Fix null pointer in login flow
Update API reference

Detailed

feat: add user authentication

- Add JWT token generation
- Add password hashing with bcrypt
- Add refresh token support

---

Recommended Models

Model	Size	Best for
qwen2.5:7b	4.7GB	Best quality
llama3.2:3b	2.0GB	Fastest
mistral:7b	4.1GB	Good balance

ollama pull qwen2.5:7b

---

Uninstall

./scripts/uninstall.sh
# or
pip uninstall komit
# or
pipx uninstall komit

---

Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature-name)
3. Commit your changes (komit 😉)
4. Push to the branch (git push origin feature-name)
5. Open a Pull Request

---

License

Apache License 2.0