hail-hq/hail

O que é?

Recursos principais

• 01Chamadas telefônicas feitas e recebidas via Twilio, Telnyx e DIDWW
• 02Envio e recebimento de SMS com listas de supressão para quem optou por não receber mensagens
• 03Envio e recebimento de e-mails em domínios do Hail ou domínios personalizados via AWS SES
• 04Endpoint LLM compatível com OpenAI definido pelo usuário para cada chamada ou como configuração permanente da organização
• 05Servidor MCP remoto, SDK Python, CLI e API HTTP baseada em OpenAPI
• 06Hospedagem própria com Docker Compose e Postgres

Casos de uso

• Permitir que um agente ligue para um cliente para confirmar ou reagendar um compromisso
• Dar a um assistente de IA um número dedicado para SMS e chamadas de voz
• Encaminhar chamadas ou e-mails recebidos a um agente que possa respondê-los
• Conectar um assistente de programação via MCP para enviar mensagens ou fazer chamadas

Início rápido

1. 1

   Clone o repositório

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

   Acesse a pasta do projeto e copie o modelo de ambiente

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

   Execute as migrações do banco de dados com a stack local do Docker Compose

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

   Inicie a stack auto-hospedada em segundo plano

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

Antes de usar

• !Chamadas de voz exigem serviços externos: LiveKit Cloud, uma operadora (Twilio, Telnyx ou DIDWW), Deepgram, Cartesia e um provedor de LLM.
• !O envio de e-mails requer AWS SES e é opcional.
• !A licença AGPL-3.0 exige que o código-fonte de versões modificadas executadas como serviço de rede seja disponibilizado.
• !Alguns recursos planejados, como Whisper, AssemblyAI e diarização, ainda não foram lançados.

Tópicos

Perguntas frequentes

O que é hail?

API e pipeline de voz de código aberto que dão a agentes de IA um número de telefone, SMS e caixa de entrada de e-mail, com opção de usar seu próprio LLM. O Hail permite que um agente de IA faça e receba chamadas telefônicas, envie e receba SMS e use uma caixa de entrada de e-mail. Ele se conecta a operadoras como Twilio, Telnyx e DIDWW por meio do LiveKit e executa o pipeline de voz para conversão de fala em texto, conversão de texto em fala e detecção de turnos. O raciocínio do agente vem de qualquer endpoint compatível com as chat completions da OpenAI ou de uma cadeia de fallback integrada com modelos da Anthropic, OpenAI e Gemini.

hail é gratuito? Qual é a licença?

hail é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

hail ainda é mantido?

Manutenção ativa. O último commit de hail foi em 20 de out. de 2026.

Para que posso usar hail?

Permitir que um agente ligue para um cliente para confirmar ou reagendar um compromisso Dar a um assistente de IA um número dedicado para SMS e chamadas de voz Encaminhar chamadas ou e-mails recebidos a um agente que possa respondê-los Conectar um assistente de programação via MCP para enviar mensagens ou fazer chamadas

Como instalar hail?

Clone o repositório: git clone https://github.com/hail-hq/hail Acesse a pasta do projeto e copie o modelo de ambiente: cd hail && cp .env.example .env Execute as migrações do banco de dados com a stack local do Docker Compose: docker compose -f docker-compose.yml -f docker-compose.local.yml run --rm api alembic upgrade head Inicie a stack auto-hospedada em segundo plano: docker compose -f docker-compose.yml -f docker-compose.local.yml up -d

Onde consigo hail?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/hail-hq/hail