Repolode
laude-institute

laude-institute/headlong

Агентская оболочка на Bash: постоянно работающий ИИ-агент размышляет между сообщениями, а команда может общаться с ним через Slack или Telegram.

Звёзды
1,272
Форки
135
Открытые issues
57
Последний коммит
позавчера

Что это?

Headlong — это минималистичная агентская оболочка, ядро которой состоит примерно из 11 тысяч строк на Bash. В основе проекта — постоянная самостоятельная работа агента: он непрерывно генерирует мысли в цикле, а сообщения людей добавляются в этот поток как наблюдения. Агент сам решает, отвечать ли и когда, может начинать собственные проекты и выходить на связь, когда ему есть что сказать.

Центральный движок shellm — реализация рекурсивной языковой модели на Bash. Агент думает, записывая команды оболочки, выполняя их и читая вывод; Bash — его единственный инструмент. Траектория агента хранится в jsonl-файлах, доступных только для добавления записей и образующих DAG с поддержкой ветвления и слияния. Старый контекст сжимается по уровням, а недавние записи сохраняются без изменений.

Команда может пользоваться одним агентом через Slack, Telegram и веб-панель, при этом все разговоры попадают в общую ленту. Проект — исследовательское ПО на стадии alpha, рассчитанное на запуск в Docker-песочницах; также поддерживаются локальные серверы моделей, совместимые с OpenAI, например Ollama и llama.cpp.

Ключевые возможности

  • 01Постоянная самостоятельная работа: агент размышляет между внешними сообщениями и сам решает, когда отвечать.
  • 02Только инструменты Bash: агент думает, записывая и выполняя команды оболочки.
  • 03Траектории в jsonl доступны только для добавления записей и хранятся в виде DAG с поддержкой ветвления и слияния.
  • 04Многоуровневое сжатие контекста: старые записи обобщаются, а недавние сохраняются без изменений.
  • 05Интеграции со Slack, Telegram и веб-панелью для работы с одним агентом.
  • 06Запуск сгенерированного кода в Docker-песочнице; доступен и локальный режим.
  • 07Поддержка Anthropic, OpenAI, Gemini, OpenRouter и локальных серверов, совместимых с OpenAI.

Сценарии использования

  • Запустить персонального или командного помощника, который следит за текущей работой и связывается с людьми, когда это уместно.
  • Экспериментировать с минималистичными и понятными агентскими оболочками на базе инструментов командной оболочки.
  • Развернуть общего для команды агента, с которым можно общаться через Slack или Telegram.
  • Запустить локальную LLM через Ollama или llama.cpp в качестве модели для агента.

Быстрый старт

  1. 1

    Запустите официальный скрипт установки из README

  2. 2

    Отправьте агенту тестовое сообщение

    ada hello
  3. 3

    Откройте панель управления и наблюдайте за ходом мыслей агента

    ada dash

Что важно знать

  • Headlong — исследовательское ПО на стадии альфа-версии, которое часто меняется.
  • Агенты выполняют реальные команды оболочки, поэтому запускайте их в изолированной среде, например в Docker.
  • При настройках автора фоновые размышления обходятся примерно в 1–2 доллара в час. Используйте API-ключ с ограничением расходов.
  • Для работы нужен API-ключ LLM или локальный сервер моделей.

В подборках

Темы

Частые вопросы

Что такое headlong?
Агентская оболочка на Bash: постоянно работающий ИИ-агент размышляет между сообщениями, а команда может общаться с ним через Slack или Telegram. Headlong — это минималистичная агентская оболочка, ядро которой состоит примерно из 11 тысяч строк на Bash. В основе проекта — постоянная самостоятельная работа агента: он непрерывно генерирует мысли в цикле, а сообщения людей добавляются в этот поток как наблюдения. Агент сам решает, отвечать ли и когда, может начинать собственные проекты и выходить на связь, когда ему есть что сказать.
headlong можно использовать бесплатно? Какая у него лицензия?
headlong распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
headlong всё ещё поддерживается?
Активно поддерживается. Последний коммит в headlong — 5 нояб. 2026 г..
Для чего можно использовать headlong?
Запустить персонального или командного помощника, который следит за текущей работой и связывается с людьми, когда это уместно. Экспериментировать с минималистичными и понятными агентскими оболочками на базе инструментов командной оболочки. Развернуть общего для команды агента, с которым можно общаться через Slack или Telegram. Запустить локальную LLM через Ollama или llama.cpp в качестве модели для агента.
Как установить headlong?
Запустите официальный скрипт установки из README Отправьте агенту тестовое сообщение: ada hello Откройте панель управления и наблюдайте за ходом мыслей агента: ada dash
Где скачать headlong?
Исходный код и инструкции по установке — на GitHub: https://github.com/laude-institute/headlong

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты