AI ReviewBot¶

Assistente basato su AI per la revisione automatica del codice nella tua pipeline CI/CD.

Cos'e?¶

AI Code Reviewer e uno strumento che analizza automaticamente le tue Pull Request (GitHub) e Merge Request (GitLab), trova problemi e suggerisce correzioni con un pulsante "Apply Suggestion". In sostanza, ottieni il punto di vista imparziale di uno sviluppatore senior sul tuo codice insieme a suggerimenti per migliorarlo.

E possibile l'integrazione con un'ampia gamma di provider LLM esistenti (di default Google Gemini, modello gemini-2.5-flash — al momento dell'attuale release, i limiti di utilizzo del tier gratuito per richieste al minuto e al giorno sono sufficienti per un flusso di lavoro normale di un team di 4-8 sviluppatori a tempo pieno).

Cosa ottieni?¶

Commenti sul Codice — valutazione generale del codice e raccomandazioni
Allineamento al Task — allineamento del PR/MR con il contesto del task
Commenti Inline — commenti direttamente sulle righe di codice
Apply Suggestion — pulsante one-click per applicare le correzioni
Spiegazioni di Mentoring — perche e importante + link alle risorse
Adattivita Linguistica — rileva la lingua dal contesto PR/MR
Metriche — tempo di esecuzione, token
Resilienza — logica di retry per errori 429/5xx

Quick Start¶

Configura AI Code Reviewer per il tuo progetto in 5 minuti:

Crea un nuovo PR/MR — ottieni una revisione automaticamente.

Importante per la qualita della revisione

La qualita della revisione dipende direttamente dalla comprensione delle tue intenzioni da parte di AI Code Reviewer (proprio come con un revisore umano reale). Pertanto, e una buona idea accompagnare il processo di sviluppo con la documentazione:

Crea un issue che descrive il problema e i risultati desiderati
Descrivi il PR/MR — il problema in dettaglio, l'approccio alla soluzione, i vincoli, i casi limite
Comunica nei commenti — se lavori in team, tutto questo aggiunge contesto

Piu contesto — migliore qualita della revisione!

Piattaforme Supportate¶

Piattaforma	Stato	Integrazione
GitHub		GitHub Actions / GitHub Action
GitLab		GitLab CI / Immagine Docker
Self-hosted		Docker / PyPI

Come funziona?¶

graph TD
    A[PR/MR creato] --> B[CI esegue AI Review]
    B --> C[Ottieni diff + contesto]
    C --> D[Analizza con Gemini]
    D --> E[Pubblica Commenti Inline]
    E --> F[Pulsante Apply Suggestion]

Passo dopo passo:

Crei un PR/MR
La pipeline CI esegue AI Code Reviewer
Lo strumento recupera diff, descrizione PR, task collegato
Gemini analizza il codice e genera raccomandazioni
I risultati vengono pubblicati come commenti inline con pulsante "Apply"

Esempio di Revisione¶

🔴 CRITICO: Secret Hardcoded

File: config.py:15

Chiave API hardcoded trovata nel codice.

API_KEY = os.getenv("API_KEY")

Perche e importante?

I secret nel codice finiscono nella cronologia git e possono essere rubati. Usa variabili d'ambiente o secret manager.

OWASP: Hardcoded Credentials

Categorie di Problemi¶

Categoria	Descrizione
Sicurezza	Vulnerabilita, secret hardcoded
Qualita del Codice	Leggibilita, naming, DRY
Architettura	SOLID, design pattern
Performance	N+1, algoritmi inefficienti
Testing	Copertura, casi limite

Installazione¶

Docker (consigliato)PyPISorgente

docker pull ghcr.io/konstziv/ai-code-reviewer:1

pip install ai-reviewbot

git clone https://github.com/KonstZiv/ai-code-reviewer.git
cd ai-code-reviewer
uv sync

Scopri di piu →

Configurazione¶

Configurazione minima — solo la chiave API:

export AI_REVIEWER_GOOGLE_API_KEY=your_api_key

Opzioni aggiuntive:

Variabile	Descrizione	Default
`AI_REVIEWER_LANGUAGE`	Lingua delle risposte (ISO 639)	`en`
`AI_REVIEWER_LANGUAGE_MODE`	`adaptive` / `fixed`	`adaptive`
`AI_REVIEWER_GEMINI_MODEL`	Modello Gemini	`gemini-2.5-flash`
`AI_REVIEWER_LOG_LEVEL`	Livello di logging	`INFO`

Nomi legacy

I vecchi nomi delle variabili senza il prefisso AI_REVIEWER_ funzionano ancora come fallback.

Tutte le opzioni →

Documentazione¶

Quick Start

Istruzioni copia-incolla per GitHub e GitLab
Configurazione

Tutte le variabili d'ambiente e opzioni
GitHub

Permessi, secret, suggerimenti workflow
GitLab

Project access token, trigger MR, self-hosted
Riferimento CLI

Comandi e parametri
Troubleshooting

FAQ e risoluzione problemi

Costi¶

AI Code Reviewer usa Google Gemini 3 Flash — in modalita Free Tier. I limiti del tier gratuito sono sufficienti per servire PR/MR per un team di 4-8 sviluppatori a tempo pieno, incluse sia revisioni che commenti significativi (senza flood e off-topic).

Se usi il tier a pagamento (Pay-as-you-go), il costo di una revisione tipica e ~$0.003–$0.01.

~1000 revisioni = ~$3 ... ~$10

Prezzi attuali →

Licenza¶

Apache 2.0 — libero di usare, modificare e distribuire.

Supporto¶

GitHub Issues — bug e suggerimenti
GitHub Discussions — domande e discussioni

Pronto a migliorare le tue code review? Inizia →