hail-hq/hail

¿Qué es?

Funciones clave

• 01Llamadas telefónicas entrantes y salientes a través de Twilio, Telnyx y DIDWW
• 02Envío y recepción de SMS con listas de supresión para quienes solicitan no recibir más mensajes
• 03Envío y recepción de correo electrónico en dominios de Hail o dominios personalizados mediante AWS SES
• 04Posibilidad de usar tu propio endpoint LLM compatible con OpenAI para cada llamada o como configuración permanente de la organización
• 05Servidor MCP remoto, SDK de Python, CLI y API HTTP basada en OpenAPI
• 06Alojamiento propio con Docker Compose y Postgres

Casos de uso

• Permitir que un agente llame a un cliente para confirmar o reprogramar una cita
• Dar a un asistente de IA un número exclusivo para SMS y llamadas de voz
• Dirigir las llamadas o los correos electrónicos entrantes a un agente que los responda
• Conectar un asistente de programación mediante MCP para enviar mensajes o hacer llamadas

Inicio rápido

1. 1

   Clona el repositorio

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

   Entra en la carpeta del proyecto y copia la plantilla de entorno

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

   Ejecuta las migraciones de la base de datos con la pila local de Docker Compose

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

   Inicia la pila autoalojada en segundo plano

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

Antes de usarlo

• !Las llamadas de voz requieren servicios externos: LiveKit Cloud, un operador (Twilio, Telnyx o DIDWW), Deepgram, Cartesia y un proveedor de LLM.
• !El correo electrónico requiere AWS SES y es opcional.
• !La licencia AGPL-3.0 exige publicar el código fuente de las versiones modificadas que se ejecuten como servicio de red.
• !Algunas funciones previstas, como Whisper, AssemblyAI y la diarización, aún no se han lanzado.

Temas

Preguntas frecuentes

¿Qué es hail?

API y pipeline de voz de código abierto que da a los agentes de IA un número de teléfono real y acceso a SMS y correo electrónico, con opción de usar tu propio LLM. Hail permite que un agente de IA haga y reciba llamadas telefónicas, envíe y reciba SMS, y use una bandeja de entrada de correo electrónico. Se conecta a operadores como Twilio, Telnyx y DIDWW mediante LiveKit, y ejecuta el pipeline de voz para convertir voz a texto, texto a voz y detectar los turnos de conversación. El razonamiento del agente puede provenir de cualquier endpoint compatible con las API de chat completions de OpenAI o de una cadena alternativa integrada de modelos de Anthropic, OpenAI y Gemini.

¿hail es gratuito? ¿Qué licencia tiene?

hail es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿hail sigue mantenido?

Mantenimiento activo. El último commit de hail fue el 20 oct 2026.

¿Para qué puedo usar hail?

Permitir que un agente llame a un cliente para confirmar o reprogramar una cita Dar a un asistente de IA un número exclusivo para SMS y llamadas de voz Dirigir las llamadas o los correos electrónicos entrantes a un agente que los responda Conectar un asistente de programación mediante MCP para enviar mensajes o hacer llamadas

¿Cómo se instala hail?

Clona el repositorio: git clone https://github.com/hail-hq/hail Entra en la carpeta del proyecto y copia la plantilla de entorno: cd hail && cp .env.example .env Ejecuta las migraciones de la base de datos con la pila local de Docker Compose: docker compose -f docker-compose.yml -f docker-compose.local.yml run --rm api alembic upgrade head Inicia la pila autoalojada en segundo plano: docker compose -f docker-compose.yml -f docker-compose.local.yml up -d

¿Dónde consigo hail?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/hail-hq/hail