smart-git-commit 0.1.0

AI-powered Git commit workflow tool

Smart Git Commit 🚀

An AI-powered Git workflow tool that intelligently analyzes your changes, groups them into logical commits, and generates detailed conventional commit messages.

Features

• 🤖 AI-Powered Analysis: Leverages Ollama models to understand your code changes
• 🔍 Intelligent Grouping: Organizes changes into logical, atomic commits
• 📝 Conventional Commits: Generates structured commit messages following the convention
• 🔄 Tech Stack Detection: Automatically adapts to different programming languages and frameworks
• 🚀 GPU Acceleration: Uses hardware acceleration for faster processing
• ⚡ Fallback Mechanism: Works even without AI using rule-based analysis
• 🎯 Smart Change Importance: Prioritizes changes based on impact analysis
• 🧩 Component Detection: Identifies file components based on project structure

Installation

# Install from PyPI
pip install smart-git-commit

# Or install directly from the repository
pip install git+https://github.com/yourusername/smart-git-commit.git

Requirements

• Python 3.7+
• Git
• Ollama (optional, for AI-powered features)

Usage

# Basic usage (will prompt for Ollama model selection)
smart-git-commit

# Disable AI-powered analysis
smart-git-commit --no-ai

# Use a specific Ollama model
smart-git-commit --ollama-model llama3

# Non-interactive mode
smart-git-commit --non-interactive

# Specify a repository path
smart-git-commit --repo-path /path/to/your/repository

# See all options
smart-git-commit --help

Command Line Options

usage: smart-git-commit [-h] [--repo-path REPO_PATH] [--non-interactive]
                        [--ollama-host OLLAMA_HOST] 
                        [--ollama-model OLLAMA_MODEL] [--no-ai]

Smart Git Commit Workflow with Ollama Integration

options:
  -h, --help            show this help message and exit
  --repo-path REPO_PATH
                        Path to the git repository
  --non-interactive     Run without interactive prompts
  --ollama-host OLLAMA_HOST
                        Host for Ollama API
  --ollama-model OLLAMA_MODEL
                        Model to use for Ollama (will prompt if not specified)
  --no-ai               Disable AI-powered analysis

Example Commit

Here's an example of a commit message generated by Smart Git Commit:

feat(api-auth): Add JWT token validation middleware

Implement secure JWT token validation with proper error handling and 
expiration checks. Add support for refresh tokens with configurable 
lifetime settings.

Affected files:
- M src/auth/jwt_validator.js
- M src/middleware/auth.js
- + src/utils/token_helpers.js
- M config/auth.json

Fixes #123

How It Works

Workflow Overview

1. Load Changes: Detects all modified and untracked files in the Git repository
2. Analyze Changes: Examines each file's content, language, and importance
3. Group Changes: Organizes related files into logical, atomic commits
4. Generate Commit Messages: Creates detailed, conventional commit messages
5. Execute Commits: Handles the git staging and commit process

Change Analysis

The tool analyzes changes through multiple dimensions:

• File Status: Checks if files are modified, added, or deleted
• Language Detection: Identifies programming languages based on file extensions
• Component Recognition: Maps files to logical components (e.g., docs, tests, api)
• Tech Stack Detection: Detects project technologies (e.g., Python, Node.js, React)
• Importance Rating: With AI, assesses the impact and significance of each change

Intelligent Grouping

Changes are grouped based on:

• Component Coherence: Files from the same component are grouped together
• Logical Relationship: AI analyzes file dependencies and relationships
• Change Size Management: Large groups are split into smaller, coherent commits
• Commit Type Assignment: Each group is assigned a conventional commit type (feat, fix, etc.)

Ollama LLM Integration

When using AI mode (default):

1. Smart Git Commit connects to Ollama's API
2. Available LLM models are detected automatically
3. The selected model analyzes file changes and content
4. AI determines logical groupings and generates commit descriptions
5. GPU acceleration is used when available

Non-AI Fallback

When AI is unavailable or disabled:

1. Files are grouped by component/directory
2. Commit types are assigned based on file paths and extensions
3. Basic commit messages are generated using rule-based templates
4. The user can interactively refine the commit details

Interactive Workflow

In interactive mode (default):

1. Each commit group is presented for review
2. You can approve, skip, or edit the commit details
3. Edit options include changing the commit name, type, description, and issue references
4. The tool handles staging and committing the files
5. You can review the final commit before proceeding to the next group

Project Structure

• CommitType Enum: Defines conventional commit types (feat, fix, docs, etc.)
• GitChange Class: Represents a changed file with metadata
• CommitGroup Class: Groups related changes for a single commit
• OllamaClient Class: Handles communication with Ollama API
• SmartGitCommitWorkflow Class: Orchestrates the entire commit process

Advanced Usage

Using Custom Ollama Endpoints

# Use a different Ollama host
smart-git-commit --ollama-host http://custom-ollama-server:11434

Non-Interactive Automation

# For CI/CD or automated scripts
smart-git-commit --non-interactive

Working with Multiple Repositories

# Specify the repository path
smart-git-commit --repo-path /path/to/your/repository

Troubleshooting

Ollama Connection Issues

If you encounter issues connecting to Ollama:

1. Ensure Ollama is running: ollama serve
2. Check that you have at least one model: ollama list
3. Try specifying the host explicitly: --ollama-host http://localhost:11434

Falling Back to Non-AI Mode

If AI analysis isn't working properly:

# Run with fallback mode explicitly
smart-git-commit --no-ai

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

To set up your development environment:

1. Clone the repository
2. Install development dependencies: pip install -e ".[dev]"
3. Run tests: pytest tests/

License

MIT

Acknowledgements

• Conventional Commits for the commit message format
• Ollama for the local LLM capabilities