ru.md

English | 简体中文 | Español | हिन्दी | Português | 日本語 | Русский | 한국어

Обзор

Создавайте автономных, надёжных, самосовершенствующихся ИИ-агентов без жёсткого кодирования рабочих процессов. Определите свою цель через разговор с кодирующим агентом, и фреймворк сгенерирует граф узлов с динамически созданным кодом соединений. Когда что-то ломается, фреймворк захватывает данные об ошибке, эволюционирует агента через кодирующего агента и переразвёртывает. Встроенные узлы человеческого вмешательства, управление учётными данными и мониторинг в реальном времени дают вам контроль без ущерба для адаптивности.

Посетите adenhq.com для полной документации, примеров и руководств.

Для кого создан Hive?

Hive создан для разработчиков и команд, которые хотят строить ИИ-агентов производственного уровня без ручной настройки сложных рабочих процессов.

Hive подойдёт вам, если вы:

• Хотите ИИ-агентов, которые выполняют реальные бизнес-процессы, а не демо
• Предпочитаете целеориентированную разработку вместо жёстко закодированных рабочих процессов
• Нуждаетесь в самовосстанавливающихся и адаптивных агентах, которые улучшаются со временем
• Требуете контроль с человеком в контуре, наблюдаемость и лимиты затрат
• Планируете запускать агентов в продакшен-среде

Hive может не подойти, если вы только экспериментируете с простыми цепочками агентов или одноразовыми скриптами.

Когда следует использовать Hive?

Используйте Hive, когда вам нужны:

• Долгосрочные автономные агенты
• Надёжные защитные барьеры, процессы и контроль
• Непрерывное улучшение на основе сбоев
• Координация нескольких агентов
• Фреймворк, который эволюционирует вместе с вашими целями

Быстрые ссылки

• Документация - Полные руководства и справочник API
• Руководство по самостоятельному хостингу - Разверните Hive в своей инфраструктуре
• История изменений - Последние обновления и релизы
• Дорожная карта - Предстоящие функции и планы
• Сообщить о проблеме - Отчёты об ошибках и запросы функций
• Участие в разработке - Как внести вклад и отправить PR

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

Предварительные требования

• Python 3.11+ для разработки агентов
• Claude Code, Codex CLI или Cursor для использования навыков агентов

Примечание для пользователей Windows: Настоятельно рекомендуется использовать WSL (Подсистему Windows для Linux) или Git Bash для запуска этого фреймворка. Некоторые основные скрипты автоматизации могут работать некорректно в стандартной командной строке или PowerShell.

Установка

Примечание Hive использует структуру рабочего пространства uv и не устанавливается через pip install. Выполнение pip install -e . из корня репозитория создаст пакет-заглушку и Hive не будет работать корректно. Пожалуйста, используйте скрипт быстрого старта ниже для настройки окружения.

# Клонировать репозиторий
git clone https://github.com/aden-hive/hive.git
cd hive


# Запустить настройку быстрого старта
./quickstart.sh

Это установит:

• framework - Основная среда выполнения агентов и исполнитель графов (в core/.venv)

• aden_tools - MCP-инструменты для возможностей агентов (в tools/.venv)

• credential store - Зашифрованное хранилище API-ключей (~/.hive/credentials)

• LLM provider - Интерактивная настройка модели по умолчанию

• Все необходимые зависимости Python через uv

• В конце будет запущен интерфейс open hive в вашем браузере

Создайте своего первого агента

Введите описание агента, которого хотите создать, в поле ввода на главном экране

Используйте шаблоны агентов

Нажмите «Try a sample agent» и просмотрите шаблоны. Вы можете запустить шаблон напрямую или создать свою версию на основе существующего шаблона.

Функции

• Browser-Use - Управление браузером на вашем компьютере для выполнения сложных задач
• Параллельное выполнение - Выполнение сгенерированного графа параллельно. Таким образом, несколько агентов могут выполнять задачи за вас
• Целеориентированная генерация - Определяйте цели на естественном языке; кодирующий агент генерирует граф агентов и код соединений для их достижения
• Адаптивность - Фреймворк захватывает сбои, калибруется в соответствии с целями и эволюционирует граф агентов
• Динамические соединения узлов - Без предопределённых рёбер; код соединений генерируется любым способным LLM на основе ваших целей
• Узлы, обёрнутые SDK - Каждый узел получает общую память, локальную RLM-память, мониторинг, инструменты и доступ к LLM из коробки
• Человек в контуре - Узлы вмешательства, которые приостанавливают выполнение для человеческого ввода с настраиваемыми таймаутами и эскалацией
• Наблюдаемость в реальном времени - WebSocket-стриминг для живого мониторинга выполнения агентов, решений и межузловой коммуникации
• Готовность к продакшену - Возможность самостоятельного хостинга, создан для масштабирования и надёжности

Интеграция

Hive создан модельно-агностичным и системно-агностичным.

• Гибкость LLM - Hive Framework разработан для поддержки различных типов LLM, включая облачные и локальные модели через LiteLLM-совместимых провайдеров.
• Подключение к бизнес-системам - Hive Framework разработан для подключения ко всем видам бизнес-систем в качестве инструментов, таким как CRM, поддержка, мессенджеры, данные, файлы и внутренние API через MCP.

Почему Aden

Hive фокусируется на генерации агентов, которые выполняют реальные бизнес-процессы, а не на создании универсальных агентов. Вместо того чтобы требовать от вас ручного проектирования рабочих процессов, определения взаимодействий агентов и реактивной обработки сбоев, Hive переворачивает парадигму: вы описываете результаты, и система строит себя сама — обеспечивая ориентированный на результат, адаптивный опыт с удобным набором инструментов и интеграций.

flowchart LR
    GOAL["Define Goal"] --> GEN["Auto-Generate Graph"]
    GEN --> EXEC["Execute Agents"]
    EXEC --> MON["Monitor & Observe"]
    MON --> CHECK{{"Pass?"}}
    CHECK -- "Yes" --> DONE["Deliver Result"]
    CHECK -- "No" --> EVOLVE["Evolve Graph"]
    EVOLVE --> EXEC

    GOAL -.- V1["Natural Language"]
    GEN -.- V2["Instant Architecture"]
    EXEC -.- V3["Easy Integrations"]
    MON -.- V4["Full visibility"]
    EVOLVE -.- V5["Adaptability"]
    DONE -.- V6["Reliable outcomes"]

    style GOAL fill:#ffbe42,stroke:#cc5d00,stroke-width:2px,color:#333
    style GEN fill:#ffb100,stroke:#cc5d00,stroke-width:2px,color:#333
    style EXEC fill:#ff9800,stroke:#cc5d00,stroke-width:2px,color:#fff
    style MON fill:#ff9800,stroke:#cc5d00,stroke-width:2px,color:#fff
    style CHECK fill:#fff59d,stroke:#ed8c00,stroke-width:2px,color:#333
    style DONE fill:#4caf50,stroke:#2e7d32,stroke-width:2px,color:#fff
    style EVOLVE fill:#e8763d,stroke:#cc5d00,stroke-width:2px,color:#fff
    style V1 fill:#fff,stroke:#ed8c00,stroke-width:1px,color:#cc5d00
    style V2 fill:#fff,stroke:#ed8c00,stroke-width:1px,color:#cc5d00
    style V3 fill:#fff,stroke:#ed8c00,stroke-width:1px,color:#cc5d00
    style V4 fill:#fff,stroke:#ed8c00,stroke-width:1px,color:#cc5d00
    style V5 fill:#fff,stroke:#ed8c00,stroke-width:1px,color:#cc5d00
    style V6 fill:#fff,stroke:#ed8c00,stroke-width:1px,color:#cc5d00

Loading

Преимущество Hive

Традиционные фреймворки	Hive
Жёсткое кодирование рабочих процессов	Описание целей на естественном языке
Ручное определение графов	Автоматически генерируемые графы агентов
Реактивная обработка ошибок	Оценка результатов и адаптивность
Статические конфигурации инструментов	Динамические узлы, обёрнутые SDK
Отдельная настройка мониторинга	Встроенная наблюдаемость в реальном времени
DIY управление бюджетом	Интегрированный контроль затрат и деградация

Как это работает

1. Определите цель → Опишите, чего хотите достичь, простым языком
2. Кодирующий агент генерирует → Создаёт граф агентов, код соединений и тестовые случаи
3. Рабочие выполняют → Узлы, обёрнутые SDK, работают с полной наблюдаемостью и доступом к инструментам
4. Плоскость управления мониторит → Метрики в реальном времени, применение бюджета, управление политиками
5. Адаптивность → При сбое система эволюционирует граф и автоматически переразвёртывает

Запуск агентов

Теперь вы можете запустить агента, выбрав его (существующего агента или пример агента). Вы можете нажать кнопку «Run» в верхнем левом углу или поговорить с агентом-маткой, и он запустит агента за вас.

Документация

• Руководство разработчика - Полное руководство для разработчиков
• Начало работы - Инструкции по быстрой настройке
• Руководство по конфигурации - Все опции конфигурации
• Обзор архитектуры - Дизайн и структура системы

Дорожная карта

Aden Hive Agent Framework призван помочь разработчикам создавать самоадаптирующихся агентов, ориентированных на результат. Подробности см. в roadmap.md.

flowchart TB
    %% Main Entity
    User([User])

    %% =========================================
    %% EXTERNAL EVENT SOURCES
    %% =========================================
    subgraph ExtEventSource [External Event Source]
        E_Sch["Schedulers"]
        E_WH["Webhook"]
        E_SSE["SSE"]
    end

    %% =========================================
    %% SYSTEM NODES
    %% =========================================
    subgraph WorkerBees [Worker Bees]
        WB_C["Conversation"]
        WB_SP["System prompt"]

        subgraph Graph [Graph]
            direction TB
            N1["Node"] --> N2["Node"] --> N3["Node"]
            N1 -.-> AN["Active Node"]
            N2 -.-> AN
            N3 -.-> AN

            %% Nested Event Loop Node
            subgraph EventLoopNode [Event Loop Node]
                ELN_L["listener"]
                ELN_SP["System Prompt<br/>(Task)"]
                ELN_EL["Event loop"]
                ELN_C["Conversation"]
            end
        end
    end

    subgraph JudgeNode [Judge]
        J_C["Criteria"]
        J_P["Principles"]
        J_EL["Event loop"] <--> J_S["Scheduler"]
    end

    subgraph QueenBee [Queen Bee]
        QB_SP["System prompt"]
        QB_EL["Event loop"]
        QB_C["Conversation"]
    end

    subgraph Infra [Infra]
        SA["Sub Agent"]
        TR["Tool Registry"]
        WTM["Write through Conversation Memory<br/>(Logs/RAM/Harddrive)"]
        SM["Shared Memory<br/>(State/Harddrive)"]
        EB["Event Bus<br/>(RAM)"]
        CS["Credential Store<br/>(Harddrive/Cloud)"]
    end

    subgraph PC [PC]
        B["Browser"]
        CB["Codebase<br/>v 0.0.x ... v n.n.n"]
    end

    %% =========================================
    %% CONNECTIONS & DATA FLOW
    %% =========================================

    %% External Event Routing
    E_Sch --> ELN_L
    E_WH --> ELN_L
    E_SSE --> ELN_L
    ELN_L -->|"triggers"| ELN_EL

    %% User Interactions
    User -->|"Talk"| WB_C
    User -->|"Talk"| QB_C
    User -->|"Read/Write Access"| CS

    %% Inter-System Logic
    ELN_C <-->|"Mirror"| WB_C
    WB_C -->|"Focus"| AN

    WorkerBees -->|"Inquire"| JudgeNode
    JudgeNode -->|"Approve"| WorkerBees

    %% Judge Alignments
    J_C <-.->|"aligns"| WB_SP
    J_P <-.->|"aligns"| QB_SP

    %% Escalate path
    J_EL -->|"Report (Escalate)"| QB_EL

    %% Pub/Sub Logic
    AN -->|"publish"| EB
    EB -->|"subscribe"| QB_C

    %% Infra and Process Spawning
    ELN_EL -->|"Spawn"| SA
    SA -->|"Inform"| ELN_EL
    SA -->|"Starts"| B
    B -->|"Report"| ELN_EL
    TR -->|"Assigned"| ELN_EL
    CB -->|"Modify Worker Bee"| WB_C

    %% =========================================
    %% SHARED MEMORY & LOGS ACCESS
    %% =========================================

    %% Worker Bees Access (link to node inside Graph subgraph)
    AN <-->|"Read/Write"| WTM
    AN <-->|"Read/Write"| SM

    %% Queen Bee Access
    QB_C <-->|"Read/Write"| WTM
    QB_EL <-->|"Read/Write"| SM

    %% Credentials Access
    CS -->|"Read Access"| QB_C

Loading

Участие в разработке

Мы приветствуем вклад сообщества! Мы особенно ищем помощь в создании инструментов, интеграций и примеров агентов для фреймворка (см. #2805). Если вы заинтересованы в расширении его функциональности, это идеальное место для начала. Пожалуйста, ознакомьтесь с CONTRIBUTING.md для руководств.

Важно: Пожалуйста, получите назначение на issue перед отправкой PR. Оставьте комментарий в issue, чтобы заявить о своём желании работать над ним, и мейнтейнер назначит вас. Issues с воспроизводимыми шагами и предложениями приоритизируются. Это помогает избежать дублирования работы.

1. Найдите или создайте issue и получите назначение
2. Сделайте форк репозитория
3. Создайте ветку функции (git checkout -b feature/amazing-feature)
4. Зафиксируйте изменения (git commit -m 'Add amazing feature')
5. Отправьте в ветку (git push origin feature/amazing-feature)
6. Откройте Pull Request

Сообщество и поддержка

Мы используем Discord для поддержки, запросов функций и обсуждений сообщества.

• Discord - Присоединиться к сообществу
• Twitter/X - @adenhq
• LinkedIn - Страница компании

Присоединяйтесь к команде

Мы нанимаем! Присоединяйтесь к нам на позициях в инженерии, исследованиях и выходе на рынок.

Посмотреть открытые позиции

Безопасность

По вопросам безопасности, пожалуйста, обратитесь к SECURITY.md.

Лицензия

Этот проект лицензирован под лицензией Apache 2.0 — см. файл LICENSE для деталей.

Часто задаваемые вопросы (FAQ)

В: Каких провайдеров LLM поддерживает Hive?

Hive поддерживает более 100 провайдеров LLM через интеграцию LiteLLM, включая OpenAI (GPT-4, GPT-4o), Anthropic (модели Claude), Google Gemini, DeepSeek, Mistral, Groq и многих других. Просто настройте соответствующую переменную окружения API-ключа и укажите имя модели. Мы рекомендуем использовать Claude, GLM и Gemini, так как они показывают лучшую производительность.

В: Могу ли я использовать Hive с локальными ИИ-моделями, такими как Ollama?

Да! Hive поддерживает локальные модели через LiteLLM. Просто используйте формат имени модели ollama/model-name (например, ollama/llama3, ollama/mistral) и убедитесь, что Ollama запущен локально.

В: Что делает Hive отличным от других фреймворков агентов?

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

В: Является ли Hive проектом с открытым исходным кодом?

Да, Hive полностью с открытым исходным кодом под лицензией Apache 2.0. Мы активно поощряем вклад и сотрудничество сообщества.

В: Может ли Hive справляться со сложными сценариями продакшен-масштаба?

Да. Hive специально разработан для продакшен-среды с такими функциями, как автоматическое восстановление после сбоев, наблюдаемость в реальном времени, контроль затрат и поддержка горизонтального масштабирования. Фреймворк справляется как с простыми автоматизациями, так и со сложными многоагентными рабочими процессами.

В: Поддерживает ли Hive рабочие процессы с человеком в контуре?

Да, Hive полностью поддерживает рабочие процессы с человеком в контуре через узлы вмешательства, которые приостанавливают выполнение для человеческого ввода. Они включают настраиваемые таймауты и политики эскалации, обеспечивая бесшовное сотрудничество между экспертами-людьми и ИИ-агентами.

В: Какие языки программирования поддерживает Hive?

Фреймворк Hive написан на Python. JavaScript/TypeScript SDK находится в дорожной карте.

В: Могут ли агенты Hive взаимодействовать с внешними инструментами и API?

Да. Узлы, обёрнутые SDK от Aden, предоставляют встроенный доступ к инструментам, и фреймворк поддерживает гибкие экосистемы инструментов. Агенты могут интегрироваться с внешними API, базами данных и сервисами через архитектуру узлов.

В: Как работает контроль затрат в Hive?

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

В: Где найти примеры и документацию?

Посетите docs.adenhq.com для полных руководств, справочника API и обучающих материалов по началу работы. Репозиторий также включает документацию в папке docs/ и подробное руководство разработчика.

В: Как я могу внести вклад в Aden?

Вклад приветствуется! Сделайте форк репозитория, создайте ветку функции, реализуйте изменения и отправьте pull request. Подробные руководства см. в CONTRIBUTING.md.

---

Made with 🔥 Passion in San Francisco