Aider + Gemma 4: Guía de instalación del mejor par de programación IA open source (2026)

Seguramente ya habrás oído hablar de Codex CLI, Cursor o Claude Code. Todos son buenos asistentes, pero todos envían tu código a servidores de terceros. Si lo que buscas es un par de programación IA totalmente open source, que corra en local y se integre con Git, Aider sigue siendo la opción más madura del mercado.

El problema es que la configuración por defecto de Aider apunta a GPT-4 o Claude, lo que se traduce en una factura mensual y en código saliendo continuamente de tu máquina. La solución: montar Gemma 4 en local con Ollama y hacer que Aider hable con él. Cero coste, cero filtración, todo en terminal.

En esta guía partimos de una terminal vacía y acabamos ejecutando cuatro escenarios reales: añadir una funcionalidad, refactorizar entre varios archivos, arreglar un test fallido y generar tests unitarios; todo ello con Gemma 4 corriendo en tu propio hardware.

Qué es Aider y en qué se diferencia de Codex CLI, Cursor y Claude Code

Aider es una herramienta de programación IA para terminal, open source y con más de 30.000 estrellas en GitHub, mantenida por Paul Gauthier desde 2023. Su filosofía es la programación en pareja con IA: no solo genera fragmentos, sino que lee todo el repo, edita archivos en su sitio y crea commits de Git con mensajes generados automáticamente.

Así se comporta frente a las alternativas habituales:

El arma secreta de Aider es el repo map: un índice basado en tree-sitter que recoge archivos, clases, funciones y dependencias, y que se envía al modelo en cada turno. Gemma 4 no adivina la forma de tu código: la ve.

Si prefieres la ruta OpenAI, revisa la guía de instalación de Gemma 4 + Codex CLI.

Requisitos previos

Antes de empezar, asegúrate de tener:

• Python 3.9+ (Aider es un proyecto Python)
• Ollama instalado y corriendo (ollama.com)
• Gemma 4 26B o 31B descargado en Ollama
• Hardware: 16 GB de RAM mínimo para 26B, 24 GB para 31B

¿No sabes qué variante elegir? Revisa la Guía de los mejores modelos de IA locales en 2026.

Paso 1: instalación de Aider

Una sola línea con pip:

pip install aider-chat

Verificación:

aider --version

En Mac o Linux con un entorno Python enmarañado, recomendamos pipx:

pipx install aider-chat

Paso 2: arrancar Ollama y confirmar Gemma 4

Levanta el servicio:

ollama serve

En otra terminal:

ollama list

Deberías ver algo parecido a:

NAME               ID           SIZE    MODIFIED
gemma4:26b-a4b     abc123...    15 GB   2 hours ago

Si no aparece Gemma 4, descárgalo:

ollama pull gemma4:26b-a4b

Paso 3: conectar Aider a Gemma 4 local

Aider soporta Ollama de forma nativa. Desde el directorio de tu proyecto:

cd /ruta/a/tu/proyecto
aider --model ollama/gemma4:26b-a4b

Esa es toda la configuración. Aider detecta http://localhost:11434 y enruta todas las peticiones a Gemma 4.

Para no tener que repetir la bandera, crea un .aider.conf.yml en la raíz del proyecto:

model: ollama/gemma4:26b-a4b

A partir de entonces basta con aider.

Configuración avanzada

Ollama en otra máquina o en un puerto no estándar:

aider --model ollama/gemma4:26b-a4b --ollama-api-base http://192.168.1.100:11434

Un modelo "fuerte" para editar y otro ligero para los mensajes de commit:

aider --model ollama/gemma4:26b-a4b --weak-model ollama/gemma4:e4b

Paso 4: cuatro escenarios reales

Escenario 1: añadir una nueva funcionalidad

Tienes un proyecto Flask y quieres un endpoint de registro. Escribe en Aider:

> En app.py añade un endpoint /register que reciba email y password, los valide y guarde el usuario en SQLite.

Aider va a:

1. Leer el repo map para entender la estructura actual
2. Editar app.py (o crear los archivos necesarios)
3. Mostrar un diff para que lo apruebes
4. Ejecutar git commit -m "feat: add /register endpoint with email/password validation" tras la aprobación

No copias ni pegas código: todo ocurre dentro de tu repositorio.

Escenario 2: refactorización entre archivos

> Extrae todas las llamadas a base de datos de utils.py a un nuevo módulo db.py y actualiza los imports.

Aquí Aider brilla: edita utils.py, crea db.py y actualiza cada archivo que importaba la ruta antigua, todo en un único commit. Codex CLI no es capaz de coordinar tantos archivos a la vez.

Escenario 3: arreglar un test que falla

> El test test_login_invalid_password de test_auth.py falla con "AssertionError: 200 != 401". Arréglalo.

Aider lee el test y el código bajo prueba, detecta el error lógico, lo corrige y reejecuta el test para confirmar que pasa.

Escenario 4: generar tests unitarios

> Escribe tests de pytest para todas las funciones públicas de db.py.

Aider crea test_db.py con casos felices y de borde para cada función y lo deja listo en un commit.

Rendimiento real de Gemma 4 en Aider

Seamos honestos: Gemma 4 26B no vence a GPT-4 Turbo en los benchmarks de programación más duros. Pero para el trabajo diario sobra.

Bien para:

• Generación y edición dentro de un solo archivo
• Refactorizaciones pequeñas (2-3 archivos)
• Corrección de bugs con mensaje de error claro
• Generación de tests
• Explicación de código

Con dificultad en:

• Refactorizaciones anchas que tocan 5 o más archivos
• Tareas que dependen de convenciones de frameworks (ViewSets de DRF, concerns de Rails)
• Contextos muy largos: aunque anuncia 128K, en la práctica la calidad cae después de 32K

Estrategia recomendada: Gemma 4 26B para el día a día (gratis y local), aider --model gpt-4o para los casos complicados. El historial de Git es compatible entre los dos.

Solución de problemas

"Model not found"

Comprueba que Ollama está en marcha (curl http://localhost:11434/v1/models) y que el nombre coincide exactamente con ollama list. Aider necesita el prefijo ollama/, por ejemplo ollama/gemma4:26b-a4b.

Respuestas lentas

Gemma 4 26B anda entre 20 y 40 tok/s en un MacBook M1. Las generaciones largas pueden tardar 30-60 segundos. Si es insoportable:

• Verifica que se usa la GPU con ollama ps
• Prueba una cuantización más agresiva
• Usa E4B para tareas rápidas y 26B solo para las complejas

No quiero commits automáticos

aider --model ollama/gemma4:26b-a4b --no-auto-commits

Aider edita archivos pero no hace commit por su cuenta.

Salida corrupta o sin sentido

Suele ser falta de contexto. Usa /drop para quitar archivos del chat y /tokens para ver el consumo actual.

FAQ

¿Aider es gratis? Aider en sí es totalmente open source (Apache 2.0). El coste depende del modelo que uses: con Gemma 4 local es 0 €.

¿Aider frente a Cursor? Cursor es un editor gráfico basado en VS Code. Aider es una herramienta de terminal pura. Los commits automáticos y el repo map son exclusivos de Aider. Se pueden combinar en el mismo proyecto sin problema.

¿Puedo usar Gemma 4 E2B (4B) con Aider? Técnicamente sí, pero la calidad de código es demasiado baja para ser útil. E4B (8B) para tareas triviales; 26B para trabajo serio.

¿Funciona en Windows? Sí. Python, Ollama y Aider funcionan en Windows Terminal o PowerShell sin problemas.

¿Qué lenguajes soporta Aider? Prácticamente todos. El repo map usa tree-sitter y cubre más de 50 lenguajes incluidos Python, TypeScript, Go, Rust, Java, C/C++ y Ruby.

¿Gemma 4 o Qwen 3 para Aider? A principios de 2026 la comunidad prefiere Gemma 4 26B por su estabilidad siguiendo instrucciones; Qwen 3 27B a veces rompe el formato de diff. Consulta nuestra comparativa Gemma 4 vs Qwen 3.

¿Puedo ejecutarlo en un servidor remoto? Sí. Monta Ollama en un servidor con GPU, conéctate por SSH y apunta --ollama-api-base a la IP del servidor.

Related Articles

• Guía de instalación Gemma 4 + Codex CLI — La alternativa sabor OpenAI
• Comparativa Gemma 4 vs Qwen 3 — Cómo elegir el modelo abierto adecuado
• Mejores modelos de IA locales en 2026 — Panorama completo antes de decidir