ralph — Loop de Agentes IA Desatendido
Resumen
Herramienta de developer, open source por Santander AI Lab, sin dependencias (Bash/PowerShell). Ejecuta un CLI de IA / agente LLM en bucle, lanzando una sesión de agente completamente nueva en cada iteración para ejecuciones largas y desatendidas. Envuelve (wrapper delgado ralph-loop.sh) CLIs ya instalados: Codex, Claude Code, Gemini CLI y Devin CLI. Técnica "Ralph Wiggum": repetir el mismo prompt contra un agente limpio, dejando que el trabajo se acumule en el repo entre corridas.
Instalación (comandos reales)
# Instalador sin dependencias (solo curl y tar); copia ralph-loop.sh a ~/.local/bin
curl -fsSL https://raw.githubusercontent.com/SantanderAI/ralph/main/install.sh | sh
# Opciones: --no-skills, --ref, --repo, --install-dir (o vars RALPH_SKIP_SKILLS, RALPH_REF, RALPH_REPO, RALPH_INSTALL_DIR)
curl -fsSL https://raw.githubusercontent.com/SantanderAI/ralph/main/install.sh | sh -s -- --no-skills
# Windows / PowerShell (pwsh 6+): instala ralph-loop.ps1
powershell -c "irm https://raw.githubusercontent.com/SantanderAI/ralph/main/install.ps1 | iex"
Requisitos
- Bash.
- Al menos uno de estos CLIs en
PATH:codex,claude,gemini,devin. - Opcional:
justpara la receta de instalación.
Patrones / Arquitectura
Cada iteración el script:
- Comprueba una señal de parada (
stop.md) y sale limpiamente si está presente. - Recarga la configuración (live reload).
- Lanza el CLI seleccionado como sesión nueva con el prompt canalizado, en el directorio donde se invocó el script.
- Escribe un log con timestamp en
.ralph/logs/y rota logs antiguos.
Pitfalls
- Como cada iteración es una sesión nueva, toda la continuidad debe vivirse en el workspace: los archivos que edita el agente, un plan, notas, etc.
- El prompt debe pedir al agente leer ese estado y avanzar incrementalmente.
- Requiere que el CLI de IA esté autenticado/accesible en
PATH;stop.mdes el mecanismo de parada.
Verificación
ralph-loop.shrelanza el agente en bucle; crearstop.mddebe abortar limpiamente.
Referencia
- Repo: https://github.com/SantanderAI/ralph (Licencia Apache 2.0). Parte de Santander AI Open Source.