laude-institute/headlong

O que é?

Recursos principais

• 01Agência persistente: o agente continua pensando entre mensagens externas e decide quando responder.
• 02Ferramentas somente em Bash: o modelo pensa escrevendo e executando comandos de shell.
• 03Trajetórias jsonl somente de acréscimo, armazenadas como um DAG com suporte a fork e merge.
• 04Compactação do contexto em camadas, que resume entradas antigas e mantém as recentes na íntegra.
• 05Integrações com Slack, Telegram e painel web que compartilham um único agente.
• 06Isolamento em sandbox Docker para código gerado, com modo local também disponível.
• 07Suporte a Anthropic, OpenAI, Gemini, OpenRouter e servidores locais compatíveis com OpenAI.

Casos de uso

• Executar um assistente pessoal ou de equipe de longa duração, que acompanha o trabalho em andamento e chama a atenção das pessoas quando relevante.
• Experimentar harnesses de agente mínimos e legíveis, construídos com ferramentas de shell.
• Hospedar um agente compartilhado com o qual a equipe pode conversar pelo Slack ou Telegram.
• Executar um LLM local por meio do Ollama ou llama.cpp como backend de modelo do agente.

Início rápido

1. 1

   Execute o script oficial de instalação do README

2. 2

   Envie uma mensagem de teste para seu agente

   ada hello
3. 3

   Abra o painel para acompanhar o agente pensando

   ada dash

Antes de usar

• !Headlong é um software de pesquisa em fase alfa e muda com frequência.
• !Os agentes executam comandos reais do shell, então execute-o em um ambiente isolado, como o Docker.
• !Com as configurações do autor, o processamento em segundo plano custa cerca de US$ 1 a US$ 2 por hora. Use uma chave de API com limite de gastos.
• !Para funcionar, ele precisa de uma chave de API de LLM ou de um servidor de modelo local.

Em coleções

Tópicos

Perguntas frequentes

O que é headlong?

Um harness de agente baseado em Bash, no qual uma IA sempre ativa continua pensando entre mensagens e pode ser compartilhada por uma equipe no Slack ou Telegram. Headlong é um micro-harness de agente com um núcleo de cerca de 11 mil linhas de Bash. A ideia principal é manter a agência persistente: o agente continua gerando pensamentos em um ciclo autoguiado, e as mensagens das pessoas são adicionadas a esse fluxo como observações. O agente decide se e quando responder, pode iniciar os próprios projetos e entrar em contato quando tiver algo a dizer.

headlong é gratuito? Qual é a licença?

headlong é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

headlong ainda é mantido?

Manutenção ativa. O último commit de headlong foi em 5 de nov. de 2026.

Para que posso usar headlong?

Executar um assistente pessoal ou de equipe de longa duração, que acompanha o trabalho em andamento e chama a atenção das pessoas quando relevante. Experimentar harnesses de agente mínimos e legíveis, construídos com ferramentas de shell. Hospedar um agente compartilhado com o qual a equipe pode conversar pelo Slack ou Telegram. Executar um LLM local por meio do Ollama ou llama.cpp como backend de modelo do agente.

Como instalar headlong?

Execute o script oficial de instalação do README Envie uma mensagem de teste para seu agente: ada hello Abra o painel para acompanhar o agente pensando: ada dash

Onde consigo headlong?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/laude-institute/headlong