O Git Commit Helper é uma ferramenta web que ajuda desenvolvedores, principalmente iniciantes, a criarem mensagens de commit claras e padronizadas seguindo a especificação Conventional Commits.
Com esta ferramenta, você pode:
- Gerar mensagens de commit padronizadas
- Escolher entre português e inglês
- Transformar descrições simples em commits profissionais
- Facilitar a manutenção de um histórico de projeto organizado
Experimente a versão online: Git Commit Helper
Nota: A versão online tem um limite de 3 gerações de commits por dia por usuário devido às limitações da API gratuita do Google Gemini.
Para executar o projeto em sua máquina sem limitações de uso, siga estas instruções:
- Python 3.8 ou superior
- pip (gerenciador de pacotes do Python)
- Uma chave de API do Google Gemini
git clone https://github.com/Moscarde/git-commit-helper.git
cd git-commit-helper
# No Windows
python -m venv venv
venv\Scripts\activate
# No Linux/MacOS
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
- Acesse a Plataforma Google AI
- Faça login com sua conta Google
- No menu, acesse "API Keys" (Chaves API)
- Clique em "Create API Key" (Criar chave API)
- Copie a chave gerada
- Crie um arquivo
.env
no diretório raiz do projeto:
cp .env.example .env
- Abra o arquivo
.env
em um editor de texto e preencha com sua chave API:
API_KEY=sua_chave_api_aqui
# No diretório raiz do projeto
python app.py
A aplicação estará disponível em http://127.0.0.1:5000
no seu navegador.
- Acesse a aplicação (online ou localmente)
- Escolha o idioma desejado (português ou inglês)
- Preencha:
- Descrição: O que você fez no código
- Arquivos alterados (opcional): Liste os principais arquivos modificados
- Contexto adicional (opcional): Forneça qualquer informação relevante
- Clique em "Gerar Commit"
- Copie a mensagem gerada para usar no seu terminal
- Backend: Python com Flask
- Frontend: HTML, CSS, JavaScript
- IA: Google Gemini API
- Deploy: Vercel
- Versão online: 7 gerações de commits por dia por usuário
- Versão local: Sem limitações, desde que respeitados os limites da sua chave API
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests com melhorias.
- Faça um fork do projeto
- Crie uma branch para sua feature (
git checkout -b feature/nova-feature
) - Commit suas mudanças (
git commit -m 'feat: adiciona nova feature'
) - Push para a branch (
git push origin feature/nova-feature
) - Abra um Pull Request
Este projeto está licenciado sob a MIT License.
Desenvolvido com 💻 por Gabriel Moscarde