hail-hq/hail

Что это?

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

• 01Исходящие и входящие звонки через Twilio, Telnyx и DIDWW
• 02Отправка и получение SMS с учётом списков номеров, отказавшихся от рассылки
• 03Отправка и получение писем на доменах Hail или собственных доменах через AWS SES
• 04Подключение собственной совместимой с OpenAI конечной точки LLM для отдельного звонка или по умолчанию для организации
• 05Удалённый MCP-сервер, Python SDK, CLI и HTTP API на основе OpenAPI
• 06Самостоятельное развёртывание с помощью Docker Compose и Postgres

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

• Поручить агенту позвонить клиенту, чтобы подтвердить или перенести встречу
• Выдать AI-ассистенту отдельный номер для SMS и голосовых звонков
• Направлять входящие звонки или письма агенту, который на них ответит
• Подключить помощника для программирования через MCP, чтобы отправлять сообщения или совершать звонки

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

1. 1

   Клонируйте репозиторий

   git clone https://github.com/hail-hq/hail
2. 2

   Перейдите в папку проекта и скопируйте шаблон окружения

   cd hail && cp .env.example .env
3. 3

   Выполните миграции базы данных с помощью локального стека Docker Compose

   docker compose -f docker-compose.yml -f docker-compose.local.yml run --rm api alembic upgrade head
4. 4

   Запустите стек для самостоятельного размещения в фоновом режиме

   docker compose -f docker-compose.yml -f docker-compose.local.yml up -d

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

• !Для голосовых вызовов нужны внешние сервисы: LiveKit Cloud, оператор связи (Twilio, Telnyx или DIDWW), Deepgram, Cartesia и поставщик LLM.
• !Для электронной почты требуется AWS SES; его использование необязательно.
• !Лицензия AGPL-3.0 требует публиковать исходный код изменённых версий, работающих как сетевой сервис.
• !Некоторые запланированные функции, например Whisper, AssemblyAI и диаризация, пока не выпущены.

Темы

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

Что такое hail?

Open-source API и голосовой пайплайн, которые дают AI-агентам номер телефона, SMS и почтовый ящик; можно подключить собственную LLM. Hail позволяет AI-агенту совершать и принимать телефонные звонки, отправлять и получать SMS, а также работать с почтовым ящиком. Проект подключается через LiveKit к операторам связи, таким как Twilio, Telnyx и DIDWW, и обеспечивает голосовой пайплайн с преобразованием речи в текст, синтезом речи и определением очередности реплик. Для рассуждений агент использует либо любую конечную точку, совместимую с OpenAI Chat Completions, либо встроенную цепочку резервных моделей Anthropic, OpenAI и Gemini.

hail можно использовать бесплатно? Какая у него лицензия?

hail распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

hail всё ещё поддерживается?

Активно поддерживается. Последний коммит в hail — 20 окт. 2026 г..

Для чего можно использовать hail?

Поручить агенту позвонить клиенту, чтобы подтвердить или перенести встречу Выдать AI-ассистенту отдельный номер для SMS и голосовых звонков Направлять входящие звонки или письма агенту, который на них ответит Подключить помощника для программирования через MCP, чтобы отправлять сообщения или совершать звонки

Как установить hail?

Клонируйте репозиторий: git clone https://github.com/hail-hq/hail Перейдите в папку проекта и скопируйте шаблон окружения: cd hail && cp .env.example .env Выполните миграции базы данных с помощью локального стека Docker Compose: docker compose -f docker-compose.yml -f docker-compose.local.yml run --rm api alembic upgrade head Запустите стек для самостоятельного размещения в фоновом режиме: docker compose -f docker-compose.yml -f docker-compose.local.yml up -d

Где скачать hail?

Исходный код и инструкции по установке — на GitHub: https://github.com/hail-hq/hail