Skip to main content

An AI-powered git commit message generator!

Project description

AI Commits

An AI-powered git commit message generator written in python. Inspired by @Nutlope

Pypi PyPI - Python Downloads MIT licensed

Description

AICommits is a Python script that generates a git commit message using OpenAI's GPT-3 language model. The script takes the git diff of the staged changes and generates a commit message using GPT-3.

The generated commit message is presented to the user who has the option to accept or reject it. If the user accepts the commit message, the script commits the changes using the generated message.

The script requires an OpenAI API key, which can be obtained from the OpenAI website.

ezgif com-video-to-gif

Dependencies

Python 3.6 or higher
openai 0.10.2
inquirer 3.7.0
python-dotenv 0.19.1

Features

In this version, AICommit provides the following features:

  • Automatic generation of commit messages based on the diff of staged changes.

  • Support for conventional commit messages.

  • Language selection for generated commit messages.

  • User selection of generated commit messages.

  • Support for specifying diff per file.

Installation and Usage

To use AICommits, do the following:

  1. Export your OpenAI API key as an environment variable by running:
export OPENAI_API_KEY=YOUR_API_KEY
  1. install aicommit from pypi by running:
pip install ai_commits

Then, run the script using the command aicommit.

This will prompt AICOMMIT to generate up to 5 commit messages based on the diff of staged changes. The user can then select one of the generated commit messages to use as the commit message for their changes.

If the --diff-per-file flag is included, AICOMMIT will generate separate commit messages for each file.

If the --conventional flag is included, AICOMMIT will generate commit messages in conventional commit format.

If the --language flag is included, AICOMMIT will generate commit messages in the specified language.

Install from Source

To install AICommits from source, follow these steps:

  1. Clone the repository using the command git clone https://github.com/nneji123/aicommit.git.

  2. Navigate to the project directory using the command cd aicommit.

  3. Install the required dependencies by running pip install -r requirements.txt.

  4. Set your OpenAI API key as an environment variable by running export OPENAI_API_KEY=YOUR_API_KEY.

  5. Run the script using the command python "src/ai_commits.py".

The script will prompt you to confirm the generated commit message. If you accept the message, the changes will be committed using the generated message.

Changelog

v1.0.0 (2023-02-16)

  • Added support for generating commit messages in multiple languages

  • Improved performance when generating commit messages for large diffs

  • Added ability to select from multiple generated commit messages using the inquirer library

  • Fixed various bugs and improved error handling

v0.0.5 (2023-02-15)

  • Fixed a bug that caused the script to fail when no changes were staged

v0.0.4 [Initial Release] (2023-02-15)

  • Initial release of aicommits
  • Supports generating conventional commit messages
  • Supports generating commit messages based on the changes in the staged files
  • Uses OpenAI's GPT-3 to generate commit messages

Contributing

Open an issue or submit a pull request if you want to contribute to the project.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ai_commits-1.0.1.tar.gz (4.3 kB view details)

Uploaded Source

Built Distribution

ai_commits-1.0.1-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

Details for the file ai_commits-1.0.1.tar.gz.

File metadata

  • Download URL: ai_commits-1.0.1.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for ai_commits-1.0.1.tar.gz
Algorithm Hash digest
SHA256 b649df7f819690fbaf4652204bb50c354214a06a18eaf86ac75c9c8f7691e436
MD5 9295c6894a35993c0f4b4af681169fbf
BLAKE2b-256 550b777d2a41aa2c34fa4acde1a86d4ccc554eb964a074fbb26f14a8f5b8b550

See more details on using hashes here.

File details

Details for the file ai_commits-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: ai_commits-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 4.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for ai_commits-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c20097a9eba07e887478f7c7d55aa1200327c1af9976c9665326fa9cf2690e33
MD5 e18af26a301e3435510351c312eaf65a
BLAKE2b-256 01bfc4d065201c308e30f687d8ea74f3445534d4a1896892d42c89503a6771a2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page