Metadata-Version: 2.1
Name: Commify
Version: 1.3.7
Summary: Commify: You Should Commit Yourself.
Home-page: https://matuco19.com/Commify
Author: Matuco19
License: MATCO-Open-Source 1.0
Project-URL: Source Code, https://github.com/Matuco19/Commify
Project-URL: Bug Tracker, https://github.com/Matuco19/Commify/issues
Keywords: python,ai,commit,git,github,gpt,language-model,gpt-3,gpt3,commits,gpt-4,gpt4,ollama,ollama-api,llama3,llama3.1,llama3.2,llama3.3,matuco19,openai,python3,gitpython
License-File: LICENSE
Requires-Dist: ollama
Requires-Dist: GitPython
Requires-Dist: g4f


# Commify

Commify is a command-line interface (CLI) tool that generates meaningful, structured commit messages for Git repositories using AI. By analyzing the staged changes (diff) in your repository, it creates commit messages that follow conventional commit guidelines, optionally including emojis for better context and readability. See [Commify](https://matuco19.com/Commify) website to know more. Don't forget to :star: the project!

>
>Ollama provider can be slow without a good GPU or a very large AI model.

---

## Features

- **AI-Powered Commit Messages:** Generate concise and structured commit messages using the `ollama` local AI provider or `G4F` AI provider.
- **Emoji Support:** Optionally include relevant emojis in commit messages.
- **Language Support:** Generate commit messages in the language of your choice.
- **Customizable Providers:** Specify the AI provider to use (g4f or ollama).
- **Interactive Review System:** Review and approve generated messages or request new ones.
- **Customizable Models:** Specify the AI model to use.

---

## Installation

>
>install by the New Way instead

### New Way

#### Windows

Make sure you have installed `Git`, `python3.8+` and `ollama` (ollama is optional)
Run the following:

```bash
pip install Commify
```

#### Linux

Make sure you have installed `Git`, `python3.8+`, `pipx` and `ollama` (ollama is optional)
If don't, use this command:

```bash
sudo apt install git
sudo apt install pipx
```

And install Commify:

```bash
pipx install Commify
pipx ensurepath
```

After that, restart your terminal and you will already have Commify installed.

### Old Way

1. **Clone the repository:**

   ```bash
   git clone https://github.com/Matuco19/commify.git
   cd commify
   ```

2. **Install dependencies:**
   Ensure you have `Python 3.8+` and `pip` installed. Then, install the required libraries:

   ```bash
   pip install -r requirements.txt
   ```

   Required libraries include:
   - `ollama` (for local AI chat capabilities)
   - `g4f` (for AI chat capabilities)
   - `gitpython` (to interact with Git repositories)
   - `argparse` (built-in Python library for parsing command-line arguments)
   - `Git` (to interact with gitpython)

3. **Add Commify to your PATH:**
   Make the script accessible globally by adding it to your system's PATH:

   ```bash
   pip install .
   ```

---

## Usage

Run the `commify` CLI with the desired options:

```bash
commify <path_to_repo> [--lang <language>] [--emoji <True/False>] [--model <AI_model>] [--provider <AI_PROVIDER>]
```

### Example

Using Ollama Provider:

```bash
commify /path/to/repo --lang english --emoji True --model llama3.1 --provider ollama
```

Using G4F Provider:

```bash
commify /path/to/repo --lang english --emoji True --model gpt-4o --provider g4f
```

Without Specifying The Repository Path:

```bash
cd /path/to/repo
commify --lang english --emoji True --model llama3.1 --provider ollama
```

### Arguments

- **`path`:** Path to the Git repository. (If the repository path is not specified, the path Commify is running from will be used)
- **`--lang`:** Language for the commit message (default: `english`).
- **`--provider`:** AI provider to use for generating messages (default: `ollama`). (required)
- **`--emoji`:** Include emojis in the commit message (`True` or `False`, default: `True`).
- **`--model`:** AI model to use for generating messages (default: `llama3.1`). (required)
- **`--help`:** Display all available parameters and their descriptions.

---

## Features in Detail

### Commit Message Review

Once a message is generated, you'll be prompted to:

- **Accept** the message (`y`).
- **Reject** the message will be generated again (`n`).
- **Cancel** the message (`c`).

---

## Testing Information

Confirmed successful runs (with no errors) on the following:

- **OS:**
  - Windows11
  - Windows10
  - Ubuntu24.04.1LTS
  - Linux Mint 22

- **Python:**
  - Python 3.11.9
  - Python 3.12.3

- **AI Models:**
  - llama3.2-vision `Ollama`
  - llama3.1 `Ollama`
  - dolphin-llama3 `Ollama`
  - gpt-4o `G4F`
  - gpt-4o-mini `G4F`

Let us know if it runs on your machine too!

---

## Developer Information

Commify is developed and maintained by **Matuco19**.

- Matuco19 Website: [matuco19.com](https://matuco19.com)  
- GitHub: [github.com/Matuco19](https://github.com/Matuco19)
- Discord Server: [discord.gg/Matuco19Server0](https://discord.gg/hp7yCxHJBw)

---

## License

![License-MATCO Open Source V1](https://img.shields.io/badge/License-MATCO_Open_Source_V1-blue.svg)

This project is open-source and available under the [MATCO-Open-Source License](https://matuco19.com/licenses/MATCO-Open-Source). See the `LICENSE` file for details.

---

### Contributions

Contributions are welcome! Feel free to open an issue or submit a pull request on [GitHub](https://github.com/Matuco19/commify).

---

Start making commits with **Commify** today! 🎉
