Repolode
hail-hq

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. 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은(는) 무엇인가요?
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 통계는 매일 갱신됩니다.

관련 프로젝트