🔍 codereview

Revisione del codice basata su AI nel tuo terminale.

Un comando. Feedback immediato. Rileva vulnerabilità di sicurezza, bug e pattern errati prima che arrivino in produzione.

Installa · Avvio rapido · Utilizzo · Provider · Contribuisci

Cosa fa

codereview invia il tuo codice a un LLM e restituisce una recensione strutturata e codificata a colori direttamente nel tuo terminale — con valutazioni di gravità, riferimenti alle righe e suggerimenti concreti per le correzioni.

Niente browser. Nessuna PR richiesta. Nessuna attesa per i colleghi. Basta:

codereview app.py

Rilevare vulnerabilità di sicurezza reali — valutazione 2/10

Recensire il proprio codice sorgente — valutazione 9/10

Perché

Sviluppatori solitari — ottieni un secondo paio di occhi senza aspettare nessuno
Controllo pre-commit — rileva bug prima che arrivino nella PR
Strumento di apprendimento — capisci perché il codice è problematico, non solo che lo è
Integrazione CI — aggiungi alla tua pipeline per revisioni automatizzate
Gratuito — funziona con Groq (livello gratuito, senza carta di credito) o completamente offline con Ollama

Cosa rileva

Gravità	Cosa trova	Esempio
🔴 Critico	Vulnerabilità di sicurezza, perdita di dati, crash	SQL injection, eval() su input utente, segreti hardcoded
🟡 Avviso	Bug, gestione errori mancante, race condition	Divisione per zero, eccezioni non gestite, perdite di risorse
🔵 Info	Miglioramenti delle prestazioni, pattern migliori	Allocazioni inutili, cache mancante, query N+1
⚪ Stile	Nomenclatura, formattazione, documentazione	Docstring mancanti, nomenclatura incoerente, codice morto

Installa

Da sorgente (consigliato)

git clone https://github.com/jaydendancer12/ai-code-review.git
cd ai-code-review
./install.sh

Oppure manualmente:

git clone https://github.com/jaydendancer12/ai-code-review.git
cd ai-code-review
pip install -e .

Tutte le dipendenze (rich, requests) si installano automaticamente. Nessun'altra configurazione necessaria.

Avvio rapido (gratuito, 60 secondi)

codereview ha bisogno di un LLM per analizzare il tuo codice. L'opzione gratuita più veloce è Groq — niente carta di credito, niente prova, solo gratuito.

Passo 1 — Ottieni una chiave API gratuita

Vai su console.groq.com
Registrati con Google o GitHub (richiede 30 secondi)
Clicca su API Keys poi Create API Key
Copia la chiave (inizia con gsk_)

Passo 2 — Imposta la tua chiave

export GROQ_API_KEY="gsk_your_key_here"

Per renderlo permanente (in modo da non doverlo impostare ad ogni sessione del terminale):

# Per zsh (predefinito su Mac)
echo 'export GROQ_API_KEY="gsk_your_key_here"' >> ~/.zshrc
source ~/.zshrc

# Per bash (predefinito su Linux)
echo 'export GROQ_API_KEY="gsk_your_key_here"' >> ~/.bashrc
source ~/.bashrc

Passo 3 — Inizializza

codereview --init groq

Passo 4 — Revisiona il codice

codereview yourfile.py

Ecco fatto. Stai eseguendo revisioni del codice con AI.

Prima volta che esegui? Basta digitare codereview senza argomenti e ti guiderà attraverso l'intera configurazione.

Utilizzo

Revisiona un file

codereview app.py

Revisiona più file

codereview src/auth.py src/db.py src/api.py

Revisiona le modifiche staged di git (pre-commit)

git add .
codereview --staged

Revisiona gli ultimi N commit

codereview --last 3

Revisiona il diff tra branch

codereview --diff origin/main

Invia codice da stdin

cat suspicious_code.py | codereview --stdin

Usa un modello specifico

codereview app.py --model gpt-4

Usa un provider specifico per una revisione

codereview app.py --provider ollama

Mostra le istruzioni di configurazione

codereview --setup

Provider

codereview funziona con qualsiasi API compatibile con OpenAI. Scegli ciò che funziona per te:

⚡ Groq (consigliato — gratuito, veloce)

export GROQ_API_KEY="gsk_your_key_here"
codereview --init groq

Costo: Livello gratuito, nessuna carta di credito richiesta
Velocità: Inferenza più veloce disponibile
Modello: Llama 3.3 70B
Ottieni una chiave: console.groq.com

🏠 Ollama (gratuito, completamente offline)

# 1. Installa Ollama
# Mac: Scarica da https://ollama.com
# Linux: curl -fsSL https://ollama.com/install.sh | sh

# 2. Scarica un modello
ollama pull llama3

# 3. Avvia il server
ollama serve

# 4. Inizializza (nessuna chiave API richiesta)
codereview --init ollama

Costo: Gratuito per sempre
Velocità: Dipende dal tuo hardware
Privacy: Il codice non lascia mai la tua macchina
Modello: Qualsiasi modello supportato da Ollama

🧠 OpenAI

export OPENAI_API_KEY="sk-..."
codereview --init openai

Costo: Paga per token
Modello: GPT-3.5 Turbo (predefinito), GPT-4 con --model gpt-4
Ottieni una chiave: platform.openai.com

🔮 Anthropic

export ANTHROPIC_API_KEY="sk-ant-..."
codereview --init anthropic

Costo: Paga per token
Modello: Claude 3 Haiku (predefinito)
Ottieni una chiave: console.anthropic.com

Configurazione

La configurazione è memorizzata in ~/.codereview/config.json:

{
  "provider": "groq",
  "model": "llama-3.3-70b-versatile",
  "base_url": "https://api.groq.com/openai/v1",
  "max_tokens": 2048,
  "temperature": 0.2
}

Le chiavi API non sono mai memorizzate nel file di configurazione. Vengono lette solo dalle variabili d'ambiente.

Sovrascrivi qualsiasi cosa tramite variabili d'ambiente

export CODEREVIEW_API_KEY="any-key"     # Sovrascrittura universale
export CODEREVIEW_MODEL="gpt-4"         # Sovrascrittura modello

Sovrascrivi tramite flag CLI

codereview app.py --model gpt-4 --provider openai

Come funziona

Tuoi Codice  -->  CLI codereview  -->  API LLM  -->  Output Strutturato Terminale
(file/diff)     (costruttore prompt)    (qualsiasi provider)  (risultati codificati a colori)

Input — codereview legge il tuo file, git diff, modifiche staged o stdin
Prompt — Costruisce un prompt di revisione mirato con regole rigorose per prevenire problemi allucinati
LLM — Invia a qualsiasi API compatibile con OpenAI (Groq, OpenAI, Anthropic, Ollama)
Analisi — Estrae JSON strutturato dalla risposta del LLM
Visualizzazione — Mostra risultati codificati a colori e ordinati per gravità nel tuo terminale

Più Popolari

ai-code-review