Repolode
laude-institute

laude-institute/headlong

常時稼働するAIエージェントがメッセージの合間も考え続け、SlackやTelegramを通じてチームで共有できる、Bashベースのエージェントハーネス。

スター
1,272
フォーク
135
未解決の Issue
57
最終コミット
一昨日

これは何?

Headlongは、約11K行のBashを中核とするエージェント向けマイクロハーネスです。中核となる考え方は、エージェントが自律性を保ち続けることです。エージェントは自ら導くループの中で思考を生成し続け、人からのメッセージは観測情報として思考の流れに加わります。返信するかどうか、いつ返信するかはエージェントが判断し、自分でプロジェクトを始めたり、伝えることができたタイミングで連絡したりできます。

中核エンジンのshellmは、再帰型言語モデルをBashで実装したものです。エージェントはシェルコマンドを書いて実行し、その出力を読むことで思考します。使うツールはBashだけです。エージェントの軌跡は追記専用のjsonlファイルに保存され、フォークとマージに対応したDAGを形成します。古いコンテキストは段階的に圧縮され、最近の記録はそのまま保持されます。

1つのエージェントをSlack、Telegram、Webダッシュボード経由でチームと共有でき、すべての会話は1つのタイムラインに集約されます。このプロジェクトはアルファ版の研究用ソフトウェアで、Dockerサンドボックスでの実行を想定しています。また、Ollamaやllama.cppなど、OpenAI互換のローカルモデルサーバーにも対応しています。

主な機能

  • 01自律的な継続動作:外部メッセージの合間も考え続け、返信するタイミングを自ら判断します。
  • 02Bashのみを使うツール環境。モデルはシェルコマンドを書いて実行することで思考します。
  • 03フォークとマージに対応したDAGとして保存される、追記専用のjsonl形式の軌跡。
  • 04古い記録を要約しつつ、最近の記録はそのまま保持する段階的なコンテキスト圧縮。
  • 051つのエージェントを共有できるSlack、Telegram、Webダッシュボード連携。
  • 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時間あたり約1~2ドルかかります。利用額に上限を設定したAPIキーを使用してください。
  • 実行にはLLM APIキーまたはローカルモデルサーバーが必要です。

収録されている特集

トピック

よくある質問

headlong とは?
常時稼働するAIエージェントがメッセージの合間も考え続け、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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト