Repolode
投稿する
anhe2021212-spec

anhe2021212-spec/Tidal_Echo

スマートフォンのPWAとClaude CodeまたはOpenAI互換LLMで動くAIコンパニオンをつなぐ、セルフホスト型の非公開1対1チャットチャンネル。

GitHub で見る
スター
326
フォーク
164
未解決の Issue
2
最終コミット
先月

これは何？

Companion Channelは、インストール可能なスマートフォン向けWebアプリ（PWA）と、自分のコンピューターまたはサーバー上で動くAIコンパニオンをつなぐ、単一ユーザー向けのチャットリレーです。スマートフォンから送ったメッセージはVPS上のSQLiteデータベースに保存され、Server-Sent Events経由でClaude Codeのchannel pluginに送られ、セッション内にchannel blocksとして表示されます。AIはreply toolを通じて返信し、その内容がスマートフォンに吹き出しとして表示されます。

標準のAI連携部分は、BunとMCPを使って構築されたClaude Code channel pluginです。代替のブリッジスクリプトexamples/bridge_any_llm.pyを使えば、フロントエンドとバックエンドはそのままに、Claude Codeの代わりにOpenAI互換モデル（GPT、DeepSeek、Geminiなど）を利用できます。さらに、複数ステップのMCPツール呼び出し、画像やファイルの添付、再起動せずに再読み込みできるペルソナファイルに対応した、サーバーサイドのAPIループも含まれています。

すべてのエンドポイントは単一のBearerシークレットRELAY_SECRETで保護されており、アカウントやサードパーティのホスティングは不要です。バックエンドはFastAPIで、前段にnginxを配置します。PWAのインストールとWeb PushにはHTTPSドメインが必要です。音声（MiniMax TTS）とプッシュ通知はオプションで、設定されていない場合は問題なく無効になります。

主な機能

  • 01SSEとHTTPを介して、スマートフォンのPWAとAIセッション間でメッセージを中継します。
  • 02BunとMCPで構築されたchannel pluginを通じてClaude Codeと連携します。
  • 03ブリッジスクリプトまたはサーバーサイドのAPIループを介して、任意のOpenAI互換モデルを利用できます。
  • 04チャット履歴を自分のサーバー上のSQLiteに保存し、Bearerトークン認証で保護します。
  • 05画像やファイルの添付に対応し、MCPツール呼び出しを展開可能なカードで表示します。
  • 06オプションでMiniMaxのテキスト読み上げと、ロック画面へのWeb Push通知を利用できます。

ユースケース

  • Claude Codeを使ったAIコンパニオンと、スマートフォンから非公開の1対1チャットをする。
  • セルフホスト型のスマートフォン向けチャットUIを、GPTやDeepSeekなどClaude以外のLLMにつなぐ。
  • 再利用可能なPWAの枠組みを、自分のメッセージバックエンドのフロントエンドとして使う。
  • MCPツールを呼び出し、ファイル添付を処理するサーバーサイドAIアシスタントを動かす。

トピック

#ai-companion#claude-code#llm#pwa#self-hosted#chatbot#mcp#privacy#ai-agents#personal-ai

よくある質問

Tidal_Echo とは？
スマートフォンのPWAとClaude CodeまたはOpenAI互換LLMで動くAIコンパニオンをつなぐ、セルフホスト型の非公開1対1チャットチャンネル。 Companion Channelは、インストール可能なスマートフォン向けWebアプリ（PWA）と、自分のコンピューターまたはサーバー上で動くAIコンパニオンをつなぐ、単一ユーザー向けのチャットリレーです。スマートフォンから送ったメッセージはVPS上のSQLiteデータベースに保存され、Server-Sent Events経由でClaude Codeのchannel pluginに送られ、セッション内にchannel blocksとして表示されます。AIはreply toolを通じて返信し、その内容がスマートフォンに吹き出しとして表示されます。
Tidal_Echo は無料で使えますか？ライセンスは？
Tidal_Echo は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
Tidal_Echo は今もメンテナンスされていますか？
半年以内に更新あり。Tidal_Echo の最終コミットは 2026年9月22日 です。
Tidal_Echo は何に使えますか？
Claude Codeを使ったAIコンパニオンと、スマートフォンから非公開の1対1チャットをする。 セルフホスト型のスマートフォン向けチャットUIを、GPTやDeepSeekなどClaude以外のLLMにつなぐ。 再利用可能なPWAの枠組みを、自分のメッセージバックエンドのフロントエンドとして使う。 MCPツールを呼び出し、ファイル添付を処理するサーバーサイドAIアシスタントを動かす。
Tidal_Echo はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/anhe2021212-spec/Tidal_Echo

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト