전화 및 브라우저 음성 에이전트를 구축·테스트·배포할 수 있는 셀프 호스팅 가능한 오픈소스 음성 AI 플랫폼으로, 비주얼 워크플로 빌더와 MCP를 지원합니다.
hail-hq/hail
AI 에이전트에 실제 전화번호, SMS, 이메일 받은 편지함을 제공하는 오픈소스 API 및 음성 파이프라인으로, LLM을 직접 연결할 수 있습니다.
대체할 수 있는 제품:Twilio
- 스타
- 32
- 포크
- 12
- 열린 이슈
- 9
- 마지막 커밋
- 12시간 전
어떤 프로젝트인가요?
Hail을 사용하면 AI 에이전트가 전화를 걸고 받거나 SMS를 주고받고 이메일 받은 편지함을 이용할 수 있습니다. LiveKit을 통해 Twilio, Telnyx, DIDWW 같은 통신사에 연결하고, 음성 인식, 음성 합성, 발화 차례 감지를 위한 음성 파이프라인을 실행합니다. 에이전트의 추론에는 OpenAI Chat Completions 호환 엔드포인트를 사용하거나 Anthropic, OpenAI, Gemini 모델로 구성된 내장 대체 체인을 사용할 수 있습니다.
프로젝트 기능은 Python SDK, `hail` CLI, OpenAPI 스펙을 제공하는 REST API, 원격 MCP 서버를 통해 사용할 수 있어 Claude Code나 Cursor 같은 도구에서 통화와 메시지를 직접 처리할 수 있습니다. Docker Compose로 자체 호스팅할 수 있으며, LiveKit Cloud와 통신사, 음성 서비스 제공업체는 외부 서비스로 이용합니다. 코드는 AGPLv3 라이선스로 배포됩니다.
핵심 기능
- 01Twilio, Telnyx, DIDWW를 통한 발신 및 수신 전화
- 02수신 거부 차단 목록을 적용한 SMS 발송 및 수신
- 03AWS SES를 통해 Hail 도메인 또는 사용자 지정 도메인으로 이메일 발송 및 수신
- 04통화별 또는 조직의 기본 설정으로 지정할 수 있는 OpenAI 호환 LLM 엔드포인트 직접 연결
- 05원격 MCP 서버, Python SDK, CLI, OpenAPI 기반 HTTP API
- 06Postgres를 사용하는 Docker Compose 자체 호스팅
활용 사례
- 에이전트가 고객에게 전화해 예약을 확인하거나 일정을 변경하도록 하기
- AI 어시스턴트에 전용 SMS 및 음성 전화번호 제공하기
- 수신 전화나 이메일을 응답을 처리하는 에이전트에 전달하기
- MCP를 통해 코딩 어시스턴트를 연결해 메시지를 보내거나 전화를 걸도록 하기
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/hail-hq/hail - 2
프로젝트 폴더로 이동해 환경 템플릿을 복사합니다
cd hail && cp .env.example .env - 3
로컬 Docker Compose 스택으로 데이터베이스 마이그레이션을 실행합니다
docker compose -f docker-compose.yml -f docker-compose.local.yml run --rm api alembic upgrade head - 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은(는) 무엇인가요?
- AI 에이전트에 실제 전화번호, SMS, 이메일 받은 편지함을 제공하는 오픈소스 API 및 음성 파이프라인으로, LLM을 직접 연결할 수 있습니다. Hail을 사용하면 AI 에이전트가 전화를 걸고 받거나 SMS를 주고받고 이메일 받은 편지함을 이용할 수 있습니다. LiveKit을 통해 Twilio, Telnyx, DIDWW 같은 통신사에 연결하고, 음성 인식, 음성 합성, 발화 차례 감지를 위한 음성 파이프라인을 실행합니다. 에이전트의 추론에는 OpenAI Chat Completions 호환 엔드포인트를 사용하거나 Anthropic, OpenAI, Gemini 모델로 구성된 내장 대체 체인을 사용할 수 있습니다.
- hail은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- hail은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- hail은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. hail의 마지막 커밋은 2026년 10월 20일입니다.
- 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
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
업무 내용을 로컬 지식 그래프로 정리하는 오픈소스 개인용 AI 어시스턴트로, 이메일, 노트, 브라우저, 회의록, 공유 Spaces를 제공합니다.
AI 에이전트가 웹 페이지를 검색하고 스크래핑하며 상호작용할 수 있는 API로, 정제된 Markdown, JSON, 스크린샷을 반환합니다.
코드, 문서, 인프라를 로컬 지식 그래프로 인덱싱해 AI 코딩 에이전트가 파일을 다시 읽는 대신 구조를 질의할 수 있게 하는 MCP 서버입니다.
Sim은 270개 이상의 연동과 주요 LLM 지원을 바탕으로 AI 에이전트와 워크플로를 구축하고 배포하며 모니터링하는 협업 워크스페이스입니다.
Claude Code, Cursor, Codex 및 20개 이상의 다른 하네스에서 코딩 에이전트 세션 기록을 수집해 재사용 가능한 지식으로 만드는 오픈 소스 메모리 계층입니다.