Repolode
Enviar
laude-institute

laude-institute/headlong

Un harness de agentes basado en Bash, donde un agente de IA siempre activo sigue pensando entre mensajes y un equipo puede compartirlo por Slack o Telegram.

Ver en GitHubSitio web
Estrellas
1,272
Forks
135
Issues abiertos
57
Último commit
anteayer

¿Qué es?

Headlong es un microharness de agentes con un núcleo de unas 11 000 líneas de Bash. Su idea principal es la agencia persistente: el agente sigue generando pensamientos en un ciclo autónomo, y los mensajes de las personas se añaden a ese flujo de pensamientos como observaciones. El agente decide si responde y cuándo hacerlo; también puede iniciar sus propios proyectos y contactar a otras personas cuando tiene algo que decir.

El motor central, shellm, es una implementación en Bash de un modelo de lenguaje recursivo. El agente piensa escribiendo comandos de shell, ejecutándolos y leyendo el resultado; Bash es su única herramienta. Su trayectoria se almacena en archivos jsonl de solo anexado que forman un DAG compatible con bifurcaciones y fusiones. El contexto antiguo se compacta por niveles, mientras que las entradas recientes se conservan literalmente.

Un equipo puede compartir un solo agente a través de Slack, Telegram y un panel web, y todas las conversaciones aparecen en una misma cronología. El proyecto es software de investigación en fase alfa y está diseñado para ejecutarse en sandboxes de Docker, con compatibilidad para servidores de modelos locales compatibles con OpenAI, como Ollama y llama.cpp.

Funciones clave

  • 01Agencia persistente: el agente sigue pensando entre mensajes externos y decide cuándo responder.
  • 02Herramientas basadas exclusivamente en Bash: el modelo piensa escribiendo y ejecutando comandos de shell.
  • 03Trayectorias de solo anexado almacenadas en jsonl como un DAG compatible con bifurcaciones y fusiones.
  • 04Compactación del contexto por niveles que resume las entradas antiguas y conserva literalmente las recientes.
  • 05Integraciones con Slack, Telegram y un panel web que comparten un mismo agente.
  • 06Aislamiento en sandboxes de Docker para el código generado, con un modo local disponible.
  • 07Compatibilidad con Anthropic, OpenAI, Gemini, OpenRouter y servidores locales compatibles con OpenAI.

Casos de uso

  • Ejecutar un asistente personal o de equipo de larga duración que siga el trabajo en curso y avise a las personas cuando sea relevante.
  • Experimentar con harnesses de agentes mínimos y fáciles de leer, basados en herramientas de shell.
  • Alojar un agente compartido con el que un equipo pueda conversar por Slack o Telegram.
  • Ejecutar un LLM local mediante Ollama o llama.cpp como backend de modelo del agente.

Inicio rápido

  1. 1

    Ejecuta el script oficial de instalación del README

  2. 2

    Envía un mensaje de prueba a tu agente

    ada hello
  3. 3

    Abre el panel para ver cómo piensa el agente

    ada dash

Antes de usarlo

  • Headlong es software de investigación en fase alfa y cambia con frecuencia.
  • Los agentes ejecutan comandos de shell reales, así que deberías ejecutarlo en un entorno aislado, como Docker.
  • Con la configuración del autor, el procesamiento en segundo plano cuesta aproximadamente entre 1 y 2 USD por hora. Usa una clave de API con un límite de gasto.
  • Para ejecutarlo, necesitas una clave de API de LLM o un servidor de modelos local.

En colecciones

Frameworks y apps de agentes de IA open source

Temas

#ai-agent#llm#bash#shell#recursive-language-model#docker#slack-bot#telegram-bot

Preguntas frecuentes

¿Qué es headlong?
Un harness de agentes basado en Bash, donde un agente de IA siempre activo sigue pensando entre mensajes y un equipo puede compartirlo por Slack o Telegram. Headlong es un microharness de agentes con un núcleo de unas 11 000 líneas de Bash. Su idea principal es la agencia persistente: el agente sigue generando pensamientos en un ciclo autónomo, y los mensajes de las personas se añaden a ese flujo de pensamientos como observaciones. El agente decide si responde y cuándo hacerlo; también puede iniciar sus propios proyectos y contactar a otras personas cuando tiene algo que decir.
¿headlong es gratuito? ¿Qué licencia tiene?
headlong es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿headlong sigue mantenido?
Mantenimiento activo. El último commit de headlong fue el 5 nov 2026.
¿Para qué puedo usar headlong?
Ejecutar un asistente personal o de equipo de larga duración que siga el trabajo en curso y avise a las personas cuando sea relevante. Experimentar con harnesses de agentes mínimos y fáciles de leer, basados en herramientas de shell. Alojar un agente compartido con el que un equipo pueda conversar por Slack o Telegram. Ejecutar un LLM local mediante Ollama o llama.cpp como backend de modelo del agente.
¿Cómo se instala headlong?
Ejecuta el script oficial de instalación del README Envía un mensaje de prueba a tu agente: ada hello Abre el panel para ver cómo piensa el agente: ada dash
¿Dónde consigo headlong?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/laude-institute/headlong

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados