🧠 CommitBro: AI-Powered Git Commit Message Generator
CommitBro is an open-source, privacy-first tool that automates and enhances your Git commit workflow using cutting-edge Local Language Models (LLMs). Powered by Ollama or an optional FastAPI backend, it generates context-aware commit messages directly from your code changes, streamlining your development process.
⸻
🚀 Key Features
- 🔒 100% Privacy-Preserving All data and model inference runs locally unless remote training is explicitly enabled—your code stays on your machine.
- 🧠 AI-Generated Commit Messages Analyzes staged changes (git diff —cached) to auto-generate clear and descriptive messages, tailored to your style.
- 🛠️ Custom LLM Support Compatible with models like Mistral, TinyLlama, Starling, Gemma, etc. You can fine-tune on your personal commit history for highly customized outputs.
- 🌐 Multilingual Output Generate commit messages in English, Spanish, Hindi, or other supported languages.
- ⚙️ Easy Integration CLI-based setup, Docker support, and optional FastAPI backend for embedding into any development workflow.
⸻
🛠 How It Works
- Install Clone the repo, install Python 3.12+ and Ollama, then run commitbro-setup to configure your preferences.
- Stage Changes Run git add . or select files to stage.
- Generate a Commit Message Run commitbro to receive an AI-suggested commit message—accept, regenerate, or skip.
- Optional Training Train CommitBro using your project’s commit history—locally or through a FastAPI-based trainer.
- Configuration Options Modify language, model, and behavior using a wizard or .commitbro/config.yaml.
⸻
🏗️ Technical Details
- Tech Stack: Python · FastAPI (optional) · Ollama (for local LLMs) · Docker
- Structure: CLI tools, training scripts, model API, backend service support
- License: MIT — free for personal and commercial use
⸻
🌍 Typical Use Cases
- Developers needing quick, high-quality commit messages without compromising code privacy
- Teams with multilingual workflows
- DevOps pipelines with automated commit messaging needs (via Docker/FastAPI integrations)
⸻
⚡ Roadmap Highlights
- 🔌 VS Code Extension (in development)
- 🖥️ Next.js + ShadCN UI GUI frontend
- 🛡️ Analytics-free SaaS for privacy-conscious teams
⸻
📈 TL;DR
CommitBro helps you write better git commit messages, faster, powered by private AI running entirely on your machine. It saves time, improves commit quality, and respects your code’s privacy.
⸻
📎 Sources & Links
- GitHub: aidataguy/commitbro
- PyPI: https://pypi.org/project/commitbro/ ⸻