GPTComet: AI-Powered Git Commit Message Generator And Reviewer

<p align="center"> <img src="artwork/logo.png" width="150" height="150" alt="GPTComet Logo"> </p>

<a href="https://www.producthunt.com/posts/gptcomet?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-gptcomet" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=774818&theme=neutral&t=1747386848397" alt="GPTComet - GPTComet&#0058;&#0032;AI&#0045;Powered&#0032;Git&#0032;Commit&#0032;Message&#0032;Generator | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>

<!-- TOC -->

• GPTComet: AI-Powered Git Commit Message Generator And Reviewer
  • 💡 Overview
  • ✨ Features
  • ⬇️ Installation
  • 📕 Usage
  • 🔧 Setup
    • Configuration Methods
    • Provider Setup Guide
      • OpenAI
      • Gemini
      • Claude/Anthropic
      • Vertex
      • Azure
      • Ollama
      • Other Supported Providers
    • Manual Provider Setup
  • ⌨️ Commands
  • ⚙ Configuration
    • file_ignore
    • provider
    • output
    • Markdown theme
    • Supported languages
    • console
  • 🔦 Supported Keys
  • 📃 Example
    • Basic Usage
    • Enhanced Error Messages
    • Progress Indicators
  • 💻 Development
    • Requirements
    • Setup
    • Running Tests
      • Go Tests
      • Python Tests
    • Code Quality
      • Go
      • Python
    • Build
  • 📩 Contact
  • ☕️ Sponsor
  • 📜 License

<!-- /TOC -->

💡 Overview

GPTComet is an AI-powered developer tool that streamlines your Git workflow and enhances code quality through automated commit message generation and intelligent code review.

✨ Features

This project leverages the power of large language models to automate repetitive tasks and improve the overall development process. The core features include:

• Automatic Commit Message Generation: GPTComet can generate commit messages based on the changes made in the code.
• Intelligent Code Review: Get AI-powered code reviews with actionable feedback and suggestions.
• Progress Indicators: Optional verbose mode shows real-time progress for long-running operations.
• Support for Multiple Languages: GPTComet supports multiple languages, including English, Chinese and so on.
• Customizable Configuration: GPTComet allows users to customize the configuration to suit their needs, such llm model and prompt.
• Support for Rich Commit Messages: GPTComet supports rich commit messages, which include a title, summary, and detailed description.
• Support for Multiple Providers: GPTComet supports multiple providers, including OpenAI, Gemini, Claude/Anthropic, Vertex, Azure, Ollama, and others.
• Support SVN and Git: GPTComet supports both SVN and Git repositories.

⬇️ Installation

To use GPTComet, you can download from Github release, or by install scripts:

curl -sSL https://cdn.jsdelivr.net/gh/belingud/gptcomet@master/install.sh | bash

Windows:

irm https://cdn.jsdelivr.net/gh/belingud/gptcomet@master/install.ps1 | iex

If you want to install specific version, you can use the following script:

curl -sSL https://cdn.jsdelivr.net/gh/belingud/gptcomet@master/install.sh | bash -s -- -v 0.4.2

irm https://cdn.jsdelivr.net/gh/belingud/gptcomet@master/install.ps1 | iex -CommandArgs @("-v", "0.4.2")

If you prefer to run in python, you can install by pip directly, it packaged the binary files corresponding to the platform already.

pip install gptcomet

# Using pipx
pipx install gptcomet

# Using uv
uv tool install gptcomet
Resolved 1 package in 1.33s
Installed 1 package in 8ms
 + gptcomet==0.1.6
Installed 2 executables: gmsg, gptcomet

📕 Usage

To use gptcomet, follow these steps:

1. Install GPTComet: Install GPTComet through pypi.
2. Configure GPTComet: See Setup. Configure GPTComet with your api_key and other required keys like:

• provider: The provider of the language model (default openai).
• api_base: The base URL of the API (default https://api.openai.com/v1).
• api_key: The API key for the provider.
• model: The model used for generating commit messages (default gpt-4o).

3. Run GPTComet: Run GPTComet using the following command: gmsg commit.

If you are using openai provider, and finished set api_key, you can run gmsg commit directly.

🔧 Setup

Configuration Methods

1. Direct Configuration

   • Configure directly in ~/.config/gptcomet/gptcomet.yaml.

2. Interactive Setup

   • Use the gmsg newprovider command for guided setup.

Provider Setup Guide

gmsg newprovider

    Select Provider

  > 1. azure
    2. chatglm
    3. claude
    4. cohere
    5. deepseek
    6. gemini
    7. groq
    8. kimi
    9. mistral
    10. ollama
    11. openai
    12. openrouter
    13. sambanova
    14. silicon
    15. tongyi
    16. vertex
    17. xai
    18. Input Manually

    ↑/k up • ↓/j down • ? more

OpenAI

OpenAI api key page: https://platform.openai.com/api-keys

gmsg newprovider

Selected provider: openai
Configure provider:

Previous inputs:
  Enter OpenAI API base: https://api.openai.com/v1
  Enter API key: sk-abc*********************************************
  Enter max tokens: 1024

Enter Enter model name (default: gpt-4o):
> gpt-4o


Provider openai configured successfully!

Gemini

Gemini api key page: https://aistudio.google.com/u/1/apikey

gmsg newprovider
Selected provider: gemini
Configure provider:

Previous inputs:
  Enter Gemini API base: https://generativelanguage.googleapis.com/v1beta/models
  Enter API key: AIz************************************
  Enter max tokens: 1024

Enter Enter model name (default: gemini-1.5-flash):
> gemini-2.0-flash-exp

Provider gemini already has a configuration. Do you want to overwrite it? (y/N): y

Provider gemini configured successfully!

Claude/Anthropic

I don't have an anthropic account yet, please see Anthropic console

Vertex

Vertex console page: https://console.cloud.google.com

gmsg newprovider
Selected provider: vertex
Configure provider:

Previous inputs:
  Enter Vertex AI API Base URL: https://us-central1-aiplatform.googleapis.com/v1
  Enter API key: sk-awz*********************************************
  Enter location (e.g., us-central1): us-central1
  Enter max tokens: 1024
  Enter model name: gemini-1.5-pro

Enter Enter Google Cloud project ID:
> test-project


Provider vertex configured successfully!

Azure

gmsg newprovider

Selected provider: azure
Configure provider:

Previous inputs:
  Enter Azure OpenAI endpoint: https://gptcomet.openai.azure.com
  Enter API key: ********************************
  Enter API version: 2024-02-15-preview
  Enter Azure OpenAI deployment name: gpt4o
  Enter max tokens: 1024

Enter Enter deployment name (default: gpt-4o):
> gpt-4o


Provider azure configured successfully!

Ollama

gmsg newprovider
Selected provider: ollama
Configure provider:

Previous inputs:
  Enter Ollama API Base URL: http://localhost:11434/api
  Enter max tokens: 1024

Enter Enter model name (default: llama2):
> llama2


Provider ollama configured successfully!

Other Supported Providers

• Groq
• Mistral
• Tongyi/Qwen
• XAI
• Sambanova
• Silicon
• Deepseek
• ChatGLM
• KIMI
• LongCat
• Cohere
• OpenRouter
• Hunyuan
• ModelScope
• MiniMax
• Yi (lingyiwanwu)

Not supported:

• Baidu ERNIE

Manual Provider Setup

Or you can enter the provider name manually, and setup config manually.

gmsg newprovider
You can either select one from the list or enter a custom provider name.
  ...
  vertex
> Input manually

Enter provider name: test
Enter OpenAI API Base URL [https://api.openai.com/v1]:
Enter model name [gpt-4o]:
Enter API key: ************************************
Enter max tokens [1024]:
[GPTComet] Provider test configured successfully.

Some special provider may need your custome config. Like cloudflare.

Be aware that the model name is not use