laude-institute/headlong

어떤 프로젝트인가요?

핵심 기능

• 01지속적인 에이전시: 외부 메시지가 없는 동안에도 계속 생각하고 언제 응답할지 결정합니다.
• 02Bash만 도구로 사용하며, 모델은 셸 명령을 작성하고 실행하는 방식으로 생각합니다.
• 03포크와 병합을 지원하는 DAG 형태로 저장되는 추가 전용 jsonl 궤적입니다.
• 04오래된 항목은 요약하고 최근 항목은 원문 그대로 유지하는 단계별 컨텍스트 압축입니다.
• 05하나의 에이전트를 공유하는 Slack, Telegram, 웹 대시보드 연동 기능입니다.
• 06생성된 코드를 위한 Docker 샌드박싱을 지원하며, 로컬 모드도 사용할 수 있습니다.
• 07Anthropic, OpenAI, Gemini, OpenRouter 및 OpenAI 호환 로컬 서버를 지원합니다.

활용 사례

• 진행 중인 작업을 계속 살피고 관련성이 있을 때 사람들에게 알림을 보내는 장기 실행 개인 또는 팀 어시스턴트를 운영합니다.
• 셸 도구를 기반으로 한 간결하고 읽기 쉬운 에이전트 하네스를 실험합니다.
• Slack이나 Telegram으로 팀이 대화할 수 있는 공유 에이전트를 호스팅합니다.
• Ollama 또는 llama.cpp를 통해 로컬 LLM을 에이전트의 모델 백엔드로 실행합니다.

빠른 시작

1. 1

   README에 있는 공식 설치 스크립트를 실행하세요

2. 2

   에이전트에게 테스트 메시지를 보내세요

   ada hello
3. 3

   대시보드를 열어 에이전트가 생각하는 모습을 확인하세요

   ada dash

사용 전 알아둘 점

• !Headlong은 알파 단계의 연구용 소프트웨어로, 자주 변경됩니다.
• !에이전트는 실제 셸 명령을 실행하므로 Docker와 같은 샌드박스에서 실행해야 합니다.
• !작성자의 설정 기준으로 백그라운드 사고 비용은 시간당 약 1~2달러입니다. 사용 한도가 설정된 API 키를 사용하세요.
• !실행하려면 LLM API 키 또는 로컬 모델 서버가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

headlong은(는) 무엇인가요?

메시지 사이에도 계속 생각하며 Slack이나 Telegram을 통해 팀과 공유할 수 있는 Bash 기반 에이전트 하네스입니다. Headlong는 약 11K줄의 Bash로 구성된 에이전트 마이크로하네스입니다. 핵심 아이디어는 지속적인 에이전시입니다. 에이전트는 스스로 이끄는 루프에서 계속 생각을 만들어 내고, 사람들의 메시지는 관찰 정보로 생각의 흐름에 추가됩니다. 에이전트는 답변할지, 언제 답변할지 스스로 결정하며, 자체 프로젝트를 시작하거나 할 말이 생겼을 때 먼저 연락할 수도 있습니다.

headlong은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

headlong은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

headlong은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. headlong의 마지막 커밋은 2026년 11월 5일입니다.

headlong은(는) 어디에 사용할 수 있나요?

진행 중인 작업을 계속 살피고 관련성이 있을 때 사람들에게 알림을 보내는 장기 실행 개인 또는 팀 어시스턴트를 운영합니다. 셸 도구를 기반으로 한 간결하고 읽기 쉬운 에이전트 하네스를 실험합니다. Slack이나 Telegram으로 팀이 대화할 수 있는 공유 에이전트를 호스팅합니다. Ollama 또는 llama.cpp를 통해 로컬 LLM을 에이전트의 모델 백엔드로 실행합니다.

headlong는 어떻게 설치하나요?

README에 있는 공식 설치 스크립트를 실행하세요 에이전트에게 테스트 메시지를 보내세요: ada hello 대시보드를 열어 에이전트가 생각하는 모습을 확인하세요: ada dash

headlong은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/laude-institute/headlong