Saltar a contenido

AI ReviewBot

Asistente impulsado por IA para revisión de código automatizada en tu pipeline de CI/CD.

¿Qué es?

AI Code Reviewer es una herramienta que analiza automáticamente tus Pull Requests (GitHub) y Merge Requests (GitLab), encuentra problemas y sugiere correcciones con un botón "Apply Suggestion". Esencialmente, obtienes la perspectiva imparcial de un desarrollador senior sobre tu código junto con sugerencias de mejora.

Es posible la integración con una amplia gama de proveedores de LLM existentes (por defecto Google Gemini, modelo gemini-2.5-flash — en el momento del lanzamiento actual, los límites de uso del nivel gratuito en solicitudes por minuto y por día son suficientes para un flujo de trabajo normal de un equipo de 4-8 desarrolladores a tiempo completo).

¿Qué obtienes?

  • ✅ Comentarios de Código — evaluación general del código y recomendaciones
  • ✅ Alineación con Tareas — alineación del PR/MR con el contexto de la tarea
  • ✅ Comentarios en Línea — comentarios directamente en las líneas de código
  • ✅ Apply Suggestion — botón de un clic para aplicar correcciones
  • ✅ Explicaciones de mentoría — por qué importa + enlaces a recursos
  • ✅ Adaptabilidad del idioma — detecta el idioma del contexto del PR/MR
  • ✅ Métricas — tiempo de ejecución, tokens
  • ✅ Resiliencia — lógica de reintentos para errores 429/5xx

Inicio Rápido

Configura AI Code Reviewer para tu proyecto en 5 minutos:

Crea un nuevo PR/MR — obtén una revisión automáticamente.

Importante para la calidad de la revisión

La calidad de la revisión depende directamente de la comprensión de AI Code Reviewer de tus intenciones (igual que con un revisor humano real). Por lo tanto, es buena idea acompañar el proceso de desarrollo con documentación:

  • Crea un issue describiendo el problema y los resultados deseados
  • Describe el PR/MR — el problema con más detalle, el enfoque de la solución, restricciones, casos especiales
  • Comunícate en los comentarios — si trabajas en equipo, todo esto añade contexto

¡Cuanto más contexto — mejor será la revisión!

Plataformas Soportadas

Plataforma Estado Integración
GitHub ✅ GitHub Actions / GitHub Action
GitLab ✅ GitLab CI / Imagen Docker
Self-hosted ✅ Docker / PyPI

¿Cómo funciona?

graph TD
    A[PR/MR creado] --> B[CI ejecuta AI Review]
    B --> C[Obtener diff + contexto]
    C --> D[Analizar con Gemini]
    D --> E[Publicar Comentarios en Línea]
    E --> F[Botón Apply Suggestion]

Paso a paso:

  1. Creas un PR/MR
  2. El pipeline de CI ejecuta AI Code Reviewer
  3. La herramienta obtiene el diff, descripción del PR, tarea vinculada
  4. Gemini analiza el código y genera recomendaciones
  5. Los resultados se publican como comentarios en línea con un botón "Apply"

Ejemplo de Revisión

🔴 CRÍTICO: Secreto Hardcodeado

Archivo: config.py:15

Se encontró una clave API hardcodeada en el código.

API_KEY = os.getenv("API_KEY")
¿Por qué importa esto?

Los secretos en el código terminan en el historial de git y pueden ser robados. Usa variables de entorno o gestores de secretos.

🔗 OWASP: Hardcoded Credentials

Categorías de Problemas

Categoría Descripción
🔒 Seguridad Vulnerabilidades, secretos hardcodeados
📝 Calidad de Código Legibilidad, nomenclatura, DRY
🏗 Arquitectura SOLID, patrones de diseño
⚡ Rendimiento N+1, algoritmos ineficientes
🧪 Testing Cobertura, casos límite

Instalación

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

👉 Más información →

Configuración

Configuración mínima — solo la clave API:

export AI_REVIEWER_GOOGLE_API_KEY=your_api_key

Opciones adicionales:

Variable Descripción Por defecto
AI_REVIEWER_LANGUAGE Idioma de respuesta (ISO 639) en
AI_REVIEWER_LANGUAGE_MODE adaptive / fixed adaptive
AI_REVIEWER_GEMINI_MODEL Modelo Gemini gemini-2.5-flash
AI_REVIEWER_LOG_LEVEL Nivel de logging INFO

Nombres legacy

Los nombres de variables antiguos sin el prefijo AI_REVIEWER_ siguen funcionando como fallback.

👉 Todas las opciones →

Documentación

Costo

AI Code Reviewer usa Google Gemini 3 Flash — en modo Free Tier. Los límites del nivel gratuito son suficientes para servir PR/MRs de un equipo de 4-8 desarrolladores a tiempo completo, incluyendo tanto revisiones como comentarios significativos (sin flood ni off-topic).

Si usas el nivel de pago (Pay-as-you-go), el costo de una revisión típica es ~$0.003–$0.01.

💡 ~1000 revisiones = ~$3 ... ~$10

👉 Precios actuales →

Licencia

Apache 2.0 — libre para usar, modificar y distribuir.

Soporte

¿Listo para mejorar tus revisiones de código? 👉 Comenzar →