Repolode
hail-hq

hail-hq/hail

AIエージェントに専用電話番号、SMS、メール受信箱を提供するオープンソースのAPI・音声パイプライン。任意のLLMを接続できます。

代替できる製品:Twilio

スター
32
フォーク
12
未解決の Issue
9
最終コミット
9 時間前

これは何?

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の送受信
  • 03HailドメインまたはカスタムドメインでのAWS SES経由のメール送受信
  • 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 の数値は毎日更新されます。

関連プロジェクト