電話やブラウザで使う音声エージェントを構築・テスト・デプロイできる、ビジュアルワークフロービルダーとMCP対応のセルフホスト可能なオープンソース音声AIプラットフォーム。
- スター
- 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
リポジトリをクローンする
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エージェントがWebページを検索・スクレイピングして操作し、整形済みのMarkdown、JSON、スクリーンショットを取得できるAPI。
コード、ドキュメント、インフラをローカルのナレッジグラフにインデックス化し、ファイルを読み直さずに構造を問い合わせられるMCPサーバー。
Simは、270以上の連携機能と主要なLLMへの対応を備え、AIエージェントやワークフローの構築、デプロイ、監視をチームで行えるワークスペースです。
Python SDK、REST API、MCPサーバーを通じて、セッションをまたいだ情報の保存と呼び出しを可能にする、AIエージェント向けのオープンソース長期記憶レイヤーです。