Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

goodfella-0.1.2.tar.gz (287.3 kB view details)

Uploaded Source

Built Distribution

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

goodfella-0.1.2-py3-none-any.whl (34.3 kB view details)

Uploaded Python 3

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

Hashes for goodfella-0.1.2.tar.gz
Algorithm Hash digest
SHA256 bfb0e42e3550558253576a0016b2be5f555fc4b79806918edac9800a3dd78e28
MD5 01cb6ab5551b8f3c98ede137124a67d4
BLAKE2b-256 a9d33e38d7726fc342a911dce4fcebf47958e37af0643849df7ba71c635e114d

See more details on using hashes here.

Provenance

The following attestation bundles were made for goodfella-0.1.2.tar.gz:

Publisher: publish.yml on BrunoSaintClair/goodfella-ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for goodfella-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 10d621e826d9035bd54bfece1f325f0076852aae40a4784c3cbf5c90d4b975ea
MD5 02be5e0b7387ae882b880862aa8aef63
BLAKE2b-256 4da95cc7a15f489f0b4ff5a691d2000fe3798679afa9cfa19a01833f6ec2fbc4

See more details on using hashes here.

Provenance

The following attestation bundles were made for goodfella-0.1.2-py3-none-any.whl:

Publisher: publish.yml on BrunoSaintClair/goodfella-ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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