- Entender cuándo compensa un agente de código local y cuándo no.
- Configurar Ollama para modelos de código con suficiente contexto.
- Crear un flujo de edición y verificación que no rompa tu repo.
El mapa honesto
Un agente local sirve muy bien para tareas acotadas: explicar código, generar tests, crear scripts, refactorizar un componente pequeño o preparar un plan de cambios. Para migraciones grandes, repositorios enormes o razonamiento largo, lo normal es usar un enfoque híbrido: local para privacidad y borradores, cloud para decisiones difíciles o revisión final.
La base práctica es Ollama. Su documentación oficial permite ejecutar modelos en macOS, Windows y Linux, y exponer una API local para integraciones. En Apple Silicon, MLX puede ser útil para experimentos y rendimiento con memoria unificada, pero no convierte cualquier portátil en una estación de trabajo ilimitada.
# 1. Comprueba Ollama
ollama --version
ollama list
# 2. Descarga un modelo de código o propósito general
ollama pull qwen2.5-coder:7b
# 3. Prueba una tarea pequeña
ollama run qwen2.5-coder:7b "Explica este bug: un array vacío rompe un reduce sin valor inicial"
# 4. API local para integraciones
curl http://localhost:11434/api/generate -d '{
"model": "qwen2.5-coder:7b",
"prompt": "Escribe una función TypeScript que valide emails sin dependencias.",
"stream": false
}'Checklist antes de dejarlo tocar archivos
- Trabaja en una rama: nunca pruebes un agente local en `main`.
- Define alcance: qué carpeta puede leer, qué archivos puede editar y qué comandos puede ejecutar.
- Exige plan: antes de editar, que liste archivos, riesgos y criterio de éxito.
- Verifica en frío: instala dependencias y corre tests después del cambio.
- Registra métricas: tiempo, tokens, errores y comandos ejecutados.
# Flujo mínimo para trabajar con seguridad git checkout -b agent-local/tarea-pequena # Pide primero un plan, no cambios # Después de aplicar cambios: npm install npm run lint npm run build git diff --stat git diff
Fuentes oficiales
Si has guardado la evidencia de esta lección, continúa con «Open WebUI + Ollama + Qdrant». Si no, repite la comprobación antes de avanzar.