GitEz 🚀
Generador interactivo, ultrarrápido y local de mensajes de commit — en español.
GitEz analiza los archivos que agregaste a staging (git add .) y te sugiere mensajes
estandarizados bajo Conventional Commits, redactados en español. Se ejecuta en milisegundos,
funciona 100% offline y no requiere API keys.
📸 Demo
⚡ Características
- 🚀 Ultra rápido: sin llamadas a servicios externos ni LLMs de pago.
- 🔒 100% privado: todo el análisis ocurre en tu máquina.
- 🇪🇸 Mensajes en español: nativo, no traducciones automáticas.
- 🎯 Sugerencias por contexto: infiere el tipo de commit (
feat,fix,docs,test,chore) según extensiones, documentación, tests y configuración. - 🏷️ Integración con tickets: detecta el ID en el nombre de la rama (
feature/PROJ-42-login→PROJ-42). - ⌨️ TUI fluida: flechas y
Enter, o escribe tu propio mensaje.
🧠 Sin IA, a propósito
GitEz no usa LLMs y es una decisión de diseño, no una limitación:
- Privacidad: tu código y tus nombres de archivo no salen de tu máquina.
- Velocidad: responde al instante, sin red ni latencia de modelo.
- Determinismo: el mismo staging produce la misma sugerencia, siempre.
Para un commit message el contexto útil son las rutas y extensiones de archivo, así que un LLM añade costo, latencia y una dependencia externa sin mejorar el resultado.
📦 Instalación
pipx install git-ez
Si el paquete aún no aparece en PyPI, instala directo desde el repositorio:
pipx install git+https://github.com/AAMoralesC/GitEz.git
Con pip convencional:
pip install git+https://github.com/AAMoralesC/GitEz.git
Desarrollo local
git clone https://github.com/AAMoralesC/GitEz.git
cd GitEz
pip install -e .
python -m unittest discover -s tests
Actualización
pipx upgrade git-ez
💻 Uso
-
Agrega tus cambios al staging como siempre:
git add .
-
Ejecuta GitEz:
git ezTambién funciona como
git-ez, comogit ez commit, o comopython -m git_ez. -
Navega con
↑/↓, elige una sugerencia o escribe tu propio mensaje, y presionaEnter. El commit se ejecuta solo.
Ejemplo de mensajes generados:
| Tipo | Ejemplo |
|---|---|
feat |
feat: actualizar main.py, utils.py |
fix |
fix: resolver problema en auth.py |
docs |
docs: actualizar documentación (README.md) |
test |
test: agregar o actualizar pruebas unitarias |
chore |
chore: actualizar dependencias y configuración del proyecto |
Con ticket en la rama (feature/PROJ-42-login):
feat: [PROJ-42] actualizar main.py, utils.py
Requisitos: Python 3.10+ y Git en el PATH. Probado en 3.10, 3.12 y 3.13.
🛠️ Stack
Python · Typer · Questionary · Rich
🤝 Contribuciones
Issues y PRs son bienvenidos. Para cambios grandes, abre primero un issue.
git checkout -b feature/mi-aporte
# ...cambios y tests...
git ez # 😉
📄 Licencia
MIT — ver LICENSE.
Metadata
Release files for git-ez 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| git_ez-1.0.0.tar.gz | 33.8 kB | Without provenance | Details for git_ez-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| git_ez-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for git_ez-1.0.0-py3-none-any.whl |
Total release size: 40.8 kB
Release files / git_ez-1.0.0.tar.gz
| Download URL | git_ez-1.0.0.tar.gz |
|---|---|
| Size | 33.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ffc525479c1f5c74eae6fb31e16c04a193e4b35098cd781c216d4243c7cee79e
|
|
BLAKE2b-256 checksum How to use checksums |
a456bbf76ea98b960b1afe9a140d45e61ab397c58baf0e36ea3b9f5690cd5a49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.9
|
Release files / git_ez-1.0.0-py3-none-any.whl
| Download URL | git_ez-1.0.0-py3-none-any.whl |
|---|---|
| Size | 7.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94305a39964e2f909e12d6c967baee9dc4586d5d69277d0be4fc92e46fa1b0e7
|
|
BLAKE2b-256 checksum How to use checksums |
e39ba0e5c559c6575866ba3a107a406dc291a91ec6d9a71ddef34f48dfcccc79
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.9
|
Security for git-ez 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.