Strict Pair Programmer CLI — AI-powered software architecture reviewer
Project description
🎩 Goodfella
Strict Pair Programmer CLI — Um assistente de IA focado estritamente em Engenharia de Software que atua como um Pair Programmer Rigoroso e Arquiteto de Software.
O que é?
O Goodfella analisa códigos, detecta violações de princípios (SOLID, Clean Architecture, DDD, etc.) e sugere melhorias. Ele não altera código diretamente — apenas aconselha.
Características
- 🔒 Local-First — Processamento padrão 100% local via Ollama
- ☁️ Multi-Provedor — Suporte a OpenAI, Anthropic, Gemini
- 🧠 RAG Inteligente — Base vetorial com ChromaDB embutido
- 📂 Isolamento por Projeto — Contextos independentes por diretório
- 💬 Chat Interativo — REPL fluido no terminal com Rich
Instalação
Via pip (quando publicado)
pip install goodfella
Via código-fonte
git clone <repo-url>
cd goodfella
uv sync
uv run goodfella
Uso
# Inicia o chat interativo no diretório do seu projeto
$ goodfella
Comandos Principais
| Comando | Descrição |
|---|---|
/review |
Revisão estrita de Clean Architecture/SOLID |
/deep-review |
Análise completa via modelo Cloud (bypass do RAG) |
/setup |
Assistente de configuração de provedor |
/status |
Saúde do sistema e provedor ativo |
/rule add |
Adicionar regra customizada |
/rebuild |
Reconstruir banco vetorial do zero |
/quit |
Encerrar e salvar histórico |
Stack Técnica
- Python + uv
- LangChain — Orquestração de IA
- ChromaDB — Banco vetorial embutido
- Rich — Interface de terminal
- Ollama — LLM local (padrão)
Licença
Proprietary / All Rights Reserved
O código-fonte é disponibilizado apenas para visualização e fins educacionais. É estritamente proibido modificar, distribuir, sublicenciar ou utilizar este projeto (ou qualquer parte dele) para fins comerciais sem autorização prévia por escrito.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file goodfella-0.1.2.tar.gz.
File metadata
- Download URL: goodfella-0.1.2.tar.gz
- Upload date:
- Size: 287.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bfb0e42e3550558253576a0016b2be5f555fc4b79806918edac9800a3dd78e28
|
|
| MD5 |
01cb6ab5551b8f3c98ede137124a67d4
|
|
| BLAKE2b-256 |
a9d33e38d7726fc342a911dce4fcebf47958e37af0643849df7ba71c635e114d
|
Provenance
The following attestation bundles were made for goodfella-0.1.2.tar.gz:
Publisher:
publish.yml on BrunoSaintClair/goodfella-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
goodfella-0.1.2.tar.gz -
Subject digest:
bfb0e42e3550558253576a0016b2be5f555fc4b79806918edac9800a3dd78e28 - Sigstore transparency entry: 1998329328
- Sigstore integration time:
-
Permalink:
BrunoSaintClair/goodfella-ai@de84ad08a1ced026ba66e4cecb95366848486c41 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/BrunoSaintClair
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@de84ad08a1ced026ba66e4cecb95366848486c41 -
Trigger Event:
push
-
Statement type:
File details
Details for the file goodfella-0.1.2-py3-none-any.whl.
File metadata
- Download URL: goodfella-0.1.2-py3-none-any.whl
- Upload date:
- Size: 34.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
10d621e826d9035bd54bfece1f325f0076852aae40a4784c3cbf5c90d4b975ea
|
|
| MD5 |
02be5e0b7387ae882b880862aa8aef63
|
|
| BLAKE2b-256 |
4da95cc7a15f489f0b4ff5a691d2000fe3798679afa9cfa19a01833f6ec2fbc4
|
Provenance
The following attestation bundles were made for goodfella-0.1.2-py3-none-any.whl:
Publisher:
publish.yml on BrunoSaintClair/goodfella-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
goodfella-0.1.2-py3-none-any.whl -
Subject digest:
10d621e826d9035bd54bfece1f325f0076852aae40a4784c3cbf5c90d4b975ea - Sigstore transparency entry: 1998329410
- Sigstore integration time:
-
Permalink:
BrunoSaintClair/goodfella-ai@de84ad08a1ced026ba66e4cecb95366848486c41 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/BrunoSaintClair
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@de84ad08a1ced026ba66e4cecb95366848486c41 -
Trigger Event:
push
-
Statement type: