autocommitt 0.3.0

A CLI tool for generating editable commit messages locally using Ollama.

AutoCommit is a free and open-source AI-powered CLI tool that generates unlimited commit messages locally using Ollama. It works entirely offline, requiring no API keys, providing developers with a private and efficient way to create concise, context-aware commit messages.

Features

• Local AI-Powered: Generates commit messages using a small LLM models locally
• Flexible Editing: Review and edit generated messages before committing
• Git Integration: Seamlessly works with your existing Git workflow
• Multiple Language Model Support: Option to choose different local AI models

Setup

Prerequisites

• Ollama: Download and install ollama from offical website.
• RAM (minimum):
  • 8GB for smaller models (<=3B parameters)
  • 16GB for optimal performance
• GPU (Optional): Boosts performance, but not required

Installation

It is recommended to use a virtual environment.

pip install autocommitt

Upgrading

Check the installed version with:

pip list | grep autocommitt

If it's not latest, make sure to upgrade.

pip install -U autocommitt

Basic Usage

1. Start the Ollama Server

   act start
   

   Note: The Ollama server starts automatically after installation. However, running this command ensures that all configuration files are updated and a default model is properly set up.

2. Stage Your Changes
   Stage the files you want to commit using Git:

   git add <files...>
   

3. Generate and Edit Commit Messages
   Generate a commit message based on your staged changes:

   act gen
   

   • The tool generates a message and allows you to review and edit it before committing.

   • To automatically push the commit to the remote repository, use the -p or --push flag:

     act gen -p
     

   Pro Tip: Save time by using the --push flag to combine committing and pushing into a single step.

4. Stop the Ollama Server
   To free up resources after you're done, stop the Ollama server:

   act stop
   

   Note: This command is supported only on Linux. On Windows and macOS, the Ollama server runs continuously as long as the machine is active.

Pro Tip: You can use the autocommitt alias for act throughout, making commands shorter and quicker to type!

Additional Commands

By default, AutoCommitt uses the llama3.2:3b model to generate commit messages.

1. Using a Custom Model

• To view the list of available models, run the following command:

  act list
  

• To select and set a model as active:

  act use <model_name>
  

  Note: If the model is not already downloaded, this command will pull the model by running ollama pull <model_name> and set it as the default.

2. Deleting a Model

act rm <model_name>

Note: Since models require a significant amount of memory (minimum 2GB), it is recommended to use only one model and delete the rest to free up space.

3. Viewing Commit History

Easily view recent commit messages using the his command:

act his -n 5

• Flag Description:-n or --limit: (Optional) Specify the number of recent commit messages to retrieve. If omitted, all commit messages will be displayed.

Pro Tip: Use this command to quickly review your project's recent changes before generating new commit messages.

How It Works

It runs the git diff --staged command to gather all staged changes and processes them using a local LLM (default: llama3.2:3b provided by Ollama). The model analyzes the changes and generates a concise, context-aware commit message, ensuring privacy and avoiding external API dependencies.

Future Enhancements

• Cross-Platform Support: Compatibility for MacOS.
• Git Hooks Integration: Compatible with pre-commit hooks
• Custom Templates: Support for user-defined commit message templates

Contributing

We welcome contributions! To report bugs, fix issues, or add features, visit the Issues page. Please review our Contribution Guide for setup and contribution instructions.

Acknowledgments

We would like to express our gratitude to the following open-source projects that made AutoCommitt possible:

• Ollama - Enables local AI with large language models.
• Typer - A CLI builder by Sebastián Ramírez, powering our command-line interface.

Special thanks to the maintainers and contributors for their outstanding work!

---