anhe2021212-spec/Tidal_Echo

何を解決するか

Tidal Echo は、モバイルデバイス（PWA経由）とローカルコンピュータまたはサーバー上で実行されるAIコンパニオンの間で、プライベートで1対1の通信チャネルを構築します。第三者のホスティングや複雑なアカウントシステムの必要性を排除し、メッセージがユーザーが所有するサーバーのみを経由するように保証します。

動作方法

このシステムは3つの主要なコンポーネントで構成されています：

1. バックエンドリレー：メッセージの保存と、Server-Sent Events (SSE) を使用したメッセージの配信を処理する FastAPI と SQLite サーバー。
2. フロントエンド PWA：ユーザーがモバイルのホーム画面にインストールして、メッセージの送受信を行う単一ページWebアプリケーション。
3. AIインターフェース：これは Claude Code チャネルプラグイン（チャットを Claude Code セッションに直接統合）またはスタンドアロンの APIループ（OpenAI互換LLMをリレーに接続するPythonスクリプト）のいずれかです。

メッセージはPWAからリレーへ流れ、その後AI側にプッシュされます。AIはツール呼び出しまたはAPIリクエストで応答し、リレーはその応答をチャットバブルまたはロック画面通知としてPWAにプッシュします。

対象ユーザー

Claude Codeや他のLLM APIを使用しているユーザーで、中央集権的なプラットフォームを避け、自前ホスティングでプライベートなAIコンパニオンインターフェースを希望する人。

特徴

• プライバシー最優先：アカウントシステムなし。アクセスは単一の共有秘密鍵（RELAY_SECRET）で制御される。
• 柔軟なAIブレイン：Claude Code用のMCPプラグインでネイティブ対応。OpenAI互換API（GPT、DeepSeek、Geminiなど）に簡単に切り替え可能。
• PWA統合：ネイティブアプリのように動作するモバイルインターフェース。ロック画面通知のプッシュに対応。
• 拡張性：MiniMax TTSによる音声応答のオプションサポートと、ユーザーが独自の実装にリレーを置き換え可能なモジュール化されたバックエンドプロトコルを備える。