README.md

metadata

title: git-commit-at
emoji: 🤖
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 6.18.0
app_file: app.py
tags:
  - build-small-hackathon
pinned: false

git-commit-app 🎯

A suite of AI-powered git commit tools for effortless, consistent commit messages.

This monorepo contains multiple projects for generating and managing git commits:

Community

• Reddit: I made a CLI that generates conventional commit messages locally using AI
• dev.to: git-commit-at — Generate conventional commit messages locally with AI, no API key needed

Projects

🚀 git-commit-at

AI-powered commit message generator with interactive CLI and web UI

• Generate conventional commit messages using AI (Ollama)
• Interactive selection from 3 AI-suggested options
• Web UI for login, commit history, and branch visualization
• Session persistence and Redis caching
• Docker Compose setup with Ollama, Redis, and Gradio

Quick start:

npm install -g git-commit-at
git add .
git commit-at

Features:

• ✅ Conventional commit format (feat:, fix:, refactor:, etc.)
• ✅ Custom commit format templates
• ✅ Ticket number integration
• ✅ Live branch graph visualization
• ✅ Commit history tracking
• 🧠 Fine-tuned model integration (see below)

Directory Structure

git-commit-app/
├── git-commit-at/          # npm package — CLI + bundled web UI
│   ├── index.js            # Core commit logic (Ollama AI)
│   ├── wrapper.js          # CLI orchestrator
│   ├── docker-compose.yml  # All services (Ollama, Redis, Gradio)
│   ├── Dockerfile          # Node app container
│   ├── entrypoint.sh       # Docker setup script
│   ├── gradio/             # Bundled web UI (Python/Gradio)
│   │   ├── app.py          # Login + history + branch visualizer
│   │   ├── auth_service.py # Redis-based user auth
│   │   ├── generate_graph.py
│   │   ├── git_graph.py
│   │   └── Dockerfile
│   └── package.json
│
└── README.md               # This file

Getting Started

Prerequisites

• Docker & Docker Compose
• Node.js 18+

Installation

npm install -g git-commit-at

First Use

# Stage your changes
git add .

# Generate commit message
git commit-at

# Follow the interactive prompts
# - Log in or register
# - Select a suggested message
# - Confirm and commit

Fine-Tuned Model Integration

git-commit-at now uses a custom fine-tuned model as its primary AI, with automatic fallback to a general model.

Model

Bhargavi5q1/git-commit-messages — Fine-tuned on 2,179 real git diffs using Unsloth + QLoRA on a Qwen2.5-Coder 1.5B base model. Trained to output conventional commit messages in one line with no explanation.

How it works

git diff (staged changes)
        │
        ▼
┌─────────────────────────────────┐
│  Fine-tuned model (primary)     │  hf.co/Bhargavi5q1/git-commit-messages
│  via Ollama                     │
└────────────┬────────────────────┘
             │ fails?
             ▼
┌─────────────────────────────────┐
│  qwen2.5-coder:1.5b (fallback)  │  general-purpose model
└─────────────────────────────────┘

• Primary model is pulled automatically on first run (~986 MB)
• If unavailable, falls back silently to qwen2.5-coder:1.5b
• Terminal shows which model was used on each run

Training details

Base model	Qwen2.5-Coder 1.5B
Method	QLoRA (Unsloth)
Dataset	2,179 git diff → commit message pairs
Epochs	3
Format	Conventional Commits
Export	GGUF Q4_K_M (~986 MB)

Architecture

┌──────────────────────────────────────────────┐
│          git-commit-at (npm package)         │
├──────────────────────────────────────────────┤
│                                              │
│  CLI (Node.js)  ←→  Docker Compose          │
│                      ├── Ollama (AI)         │
│                      ├── Redis (cache)       │
│                      ├── Gradio (web UI)     │
│                      └── commit-at (Node)    │
│                                              │
└──────────────────────────────────────────────┘

Features Overview

git-commit-at

• 🤖 AI Suggestions — 3 smart commit message options
• 🎯 Conventional Format — Follows commit standards
• 🌐 Web UI — Login, history, branch visualization
• 📝 Custom Formats — Define your own commit template
• 🔐 Session Persistence — Stay logged in
• 🐳 Docker Ready — One-click setup
• 📊 Branch Visualizer — See your git graph live

Development

Project Docs

• git-commit-at: README — Full setup, troubleshooting, contributing

Development Workflow

# Install all dependencies
npm install

# Run services
docker compose up -d

# Access web UI
# http://localhost:7860

# Run CLI
node wrapper.js

File Structure (git-commit-at)

File	Purpose
wrapper.js	CLI entry; manages Docker services
index.js	Main commit logic
diff-parser.js	Parses git diffs
entrypoint.sh	Docker setup
gradio/app.py	Web UI
gradio/git_graph.py	Branch visualization

Contributing

We welcome contributions! Here's how:

1. Fork the repo
2. Create a branch for your feature: git checkout -b feature/my-feature
3. Make changes and test locally
4. Use git-commit-at for your commits 😉
5. Push and open a PR

Commit Guidelines

Use Conventional Commits:

• feat: — New feature
• fix: — Bug fix
• docs: — Documentation
• refactor: — Code refactor
• test: — Tests
• chore: — Build, dependencies, etc.

Troubleshooting

General Issues

Problem	Solution
Docker won't start	Check if Docker daemon is running
Port already in use	Change port in docker-compose.yml
"Not a git repo"	Run from inside a git repository

git-commit-at Issues

See git-commit-at Troubleshooting

Performance

Operation	Time
First run (download models)	~30s
Generate suggestions	~5-10s
Web UI load	<1s

Environment Setup

Using Docker (Recommended)

Everything runs in containers—no local setup needed!

docker compose up -d
npm start

Local Development

# Set up Node environment
node --version  # Should be 18+

# Install deps
npm install

# Start Docker services only
docker compose up -d ollama redis gradio

# Run app
node wrapper.js

FAQ

Q: Do I need Ollama installed locally? A: No! Ollama runs in a Docker container. Just ensure Docker is running.

Q: Which AI model does this use? (Inprogress) A: A custom fine-tuned model (Bhargavi5q1/git-commit-messages) trained specifically for git commit messages. Falls back to qwen2.5-coder:1.5b if unavailable.

Q: Does this work offline? A: After the first run (which downloads the AI model), yes!

Q: Can I use this without the web UI? A: Yes! Just run git-commit-at from the CLI.

Q: How do I customize the commit format? A: You'll be prompted each time. Or edit the format in the Gradio UI after logging in.

License

MIT — See LICENSE for details

Links

• 🐳 Docker Hub: git-commit-at
• 🤗 Hugging Face: Fine-tuned model · Spaces
• 📦 NPM: git-commit-at

Support

• 📖 Docs: Check individual project READMEs
• 🐛 Issues: Report on GitHub
• 💬 Discussions: Ask questions in GitHub Discussions

---

Made with ❤️ for developers who want better commits, faster.

🚀 Start generating smarter commits today!