Honcho: управление памятью для адаптивных ИИ-агентов

**Honcho** — это инфраструктура для построения агентств с долговременной памятью, которые могут обрабатывать и анализировать изменяющиеся данные о людях, агентах, группах, проектах и идеях со временем. Этот проект позволит тебе хранить сообщения и события, обрабатывать их в фоновом режиме и запрашивать контекст с использованием различных моделей и фреймворков.

Ты можешь использовать Honcho как управляемый сервис через api.honcho.dev, запустить локальную версию с помощью команды honcho start или развернуть собственный сервер на FastAPI.

Установка и запуск

Чтобы начать работу с Honcho, тебе нужно получить API-ключ на app.honcho.dev. После регистрации ты получишь доступ к бесплатным кредитам в размере $100 для использования сервиса.

Быстрая установка:

Для Python:

pip install honcho-ai

Для TypeScript:

npm install @honcho-ai/sdk

Для запуска локальной версии Honcho, найди в README следующие команды:

honcho start --setup

Если ты хочешь развернуть Honcho самостоятельно, тебе нужно клонить репозиторий и настроить окружение:

git clone https://github.com/plastic-labs/honcho.git
cd honcho
cp docker-compose.yml.example docker-compose.yml
cp .env.template .env  # настроить переменные окружения
docker compose up

Функции и возможности

Honcho предоставляет множество функций для управления памятью агентов:

• Сохранение истории взаимодействий с помощью session.add_messages(...).
• Запрос информации о peer через peer.chat(...).
• Получение контекста для всей рабочей области с использованием honcho.chat(...).
• Поиск по взаимодействиям использует гибридный подход (BM25 + векторный поиск).
• Доступ к статическим представлениям данных с помощью peer.representation(...).

Honcho поддерживает интеграции с различными агентами, такими как Claude Code, Codex, Cursor и другими, что позволяет использовать одну конфигурацию для всех. Все интеграции хранятся в файле ~/.honcho/config.json.

Ограничения

В README не указаны конкретные ограничения, но стоит отметить, что фоновая обработка информации осуществляется асинхронно. Это значит, что новые сообщения могут появляться в ответах немного с задержкой. Для инструментов, работающих в реальном времени, можно использовать специальный representation эндпоинт для получения актуальных данных.

Лицензия

Honcho размещен под лицензией AGPL-3.0, что означает, что проект является открытым для использования и модификации при условии соблюдения условий лицензии.