Skip to main content

Asistente inteligente para atuomatizar tareas de Git y GitHub

Project description

AI Git Assistant 🤖📦

PyPI version License

📄 This README is also available in: Español

Intelligent Git assistant that automates semantic commit creation and generates Pull Request templates, with support for change analysis and AI-based suggestions.

✨ Key Features

  • 🧠 Smart commit suggestions using ML (Naive Bayes + TF-IDF)
  • 📝 Automatic message generation with multiple approaches:
    • File type-based
    • Change-based
    • Code theme-based
  • 🔍 Automatic detection of modified files (staged/unstaged/untracked)
  • 📊 Change analysis by file type (code, docs, tests, etc.)
  • 📑 PR template with:
    • Organized list of modified files
    • Testing considerations section
    • Compatible applications table
  • 🛠️ SQL support with special .sql file detection
  • 🌍 Spanish interface (easy to internationalize)

📦 Installation

pip install ai-git-assistant

Or install from source:

https://github.com/LuisGH28/git_assitant.git
cd git_assitant
pip install .

🎥 Demo

Animated Demo

demo

Result of the suggestion for the PR

result

result

Note: you must be in the root of the project, as shown in the gif, if all your project is in the example folder in the terminal you must be located in the example and there you can run with the command ai-git-assistant


🏗️ Project Structure

ai-git-assistant/
├── __init__.py
├── __main__.py            # Main logic
├── requirements.txt       # Dependencies
tests/
├── tests_cli.py           # Interface tests
└── tests_git_utils.py     # Git functionality tests

📌 Requirements

  • Python 3.8+
  • Git installed and configured
  • Dependencies:
    • scikit-learn
    • joblib

🛠️ Development

  1. Clone the repository
  2. Create a virtual environment:
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
  1. Install dependencies:
pip install -e ".[dev]"
  1. Run tests:
pytest

🤖 Roadmap

  • Support for more languages (i18n)
  • Integration with GitHub/GitLab APIs
  • Non-interactive mode for CI/CD
  • Editor plugins (VSCode, PyCharm)

🎉 Available on PyPI!

pip install ai-git-assistant

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_git_assistant-1.0.5.tar.gz (11.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ai_git_assistant-1.0.5-py3-none-any.whl (11.0 kB view details)

Uploaded Python 3

File details

Details for the file ai_git_assistant-1.0.5.tar.gz.

File metadata

  • Download URL: ai_git_assistant-1.0.5.tar.gz
  • Upload date:
  • Size: 11.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for ai_git_assistant-1.0.5.tar.gz
Algorithm Hash digest
SHA256 afbe8a06a60e508fe26265ec6e9e57a5c04850c110f97623d382f8c160be92ec
MD5 5d9c896b1485bcd7bf8496d8661f767f
BLAKE2b-256 02d3ed1c71458443ea6fb3b2262f8296bf988f45f9ef3113085df8deaa51a120

See more details on using hashes here.

File details

Details for the file ai_git_assistant-1.0.5-py3-none-any.whl.

File metadata

File hashes

Hashes for ai_git_assistant-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 8a8f8cf8a466f1e3479154f1172aea97c6682bf6ac9c717e5ac1702c8cf9f6c3
MD5 673a58ba0386372250f8eeaf9f76f0bc
BLAKE2b-256 054b86e7d20f7f1ad4756e680ee2029aaae4633d8428dd5cca708bd6676d8804

See more details on using hashes here.

Supported by

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