rociiu/talorys

Talorys – Cloudflareアカウントでホストされる個人用AIアシスタント

概要

• 個人のCloudflareアカウント内で完全に動作する、オープンソースのシングルユーザー向けAIアシスタントです。
• チャット、メモリ、タスク/ノート/プロジェクト管理、およびスケジュール自動化（リマインダー、ダイジェスト、AI駆動のルーチン）を提供します。
• 外部サーバーやデータベースは不要で、すべてのデータは所有するSQLiteベースの Durable Object に保存されます。

仕組み

1. フロントエンド – Cloudflare Pages (*.pages.dev) から配信されるReact/Viteアプリ。
2. API層 – プライベートなCloudflare Workers関数 (Hono router) が、service binding を介して専用Workerにリクエストを転送します。
3. エージェント – Workerは TalorysAgent (Cloudflare Agents SDK) を実行し、以下の処理を行います：
   • 会話、メモリ、タスク、ノート、プロジェクト、自動化などをSQLiteに保存。
   • Workers AI (@cf/zai-org/glm-4.7-flash) を呼び出し、ストリーミングチャットとツール呼び出しを実行。
   • Durable Objectのアラームを使用して、リマインダーや定期スケジュールを管理。
4. セキュリティ – 認証はWorker内で行われ、所有者のパスワードはローカルでハッシュ化され、Cloudflareシークレットとしてのみ保存されます。テレメトリデータがアカウント外に出ることはありません。

主な機能

• チャット: ストリーミング応答、Markdownレンダリング、可視化されたツールアクティビティ。
• メモリ: 持続的な個人的事実の保存。オプションで意味ベースの検索（セマンティックリコール）が可能。
• タスク・ノート・プロジェクトのCRUD: UIまたはチャットコマンドから直接操作可能。
• 自動化: 一回限りまたは定期的なリマインダー、日次ダイジェスト、AIルーチン。Durable Objectのアラームで実行されるため、常時オンラインである必要はありません。
• オフラインモード: Workers AIのクォータが尽きても、タスクやノートは引き続き動作します。
• バックアップと復元: 個人データのJSONバックアップをダウンロード可能。インポート時は安全にマージされます。
• セルフホスト無料枠: Cloudflare Workersの無料プラン（Pages、Workers、Durable Objects、Workers AIの無料枠）に収まるように設計されています。有料サービスが自動的にプロビジョニングされることはありません。

インストール

npx create-talorys@latest

インストーラーが以下をガイドします：

• Node 22+ のチェック、Cloudflareログイン、アカウント選択。
• 所有者パスワードの設定（ローカルでハッシュ化）。
• シークレットとリソース名の生成、プライベートWorkerとPagesサイトのデプロイ。
• AIを呼び出さずにデプロイの検証。 将来のアップデートに必要な非機密設定を含む talorys/ フォルダが作成されます。

開発

• リポジトリをクローンし、npm install を実行後、npm run dev でWorker、Pagesプロキシ、Vite UIをローカルで起動します。
• 決定論的なモックAIプロバイダーを使用するため、ローカル開発にCloudflareログインは不要です。
• 完全なテストスイート（ユニット、e2e、スモーク）とTypeScriptの型チェックが含まれています。

メンテナンス

• npx create-talorys@latest update で更新 – Durable Objectの名前空間とパスワードを保持したままコードを再デプロイします。
• npx create-talorys@latest reset-password でパスワードをリセット。
• npx create-talorys@latest doctor でヘルスチェックを実行。

対象ユーザー

• サーバー管理をせずに、プライベートなセルフホスト型AIアシスタントを求めるユーザー。
• Cloudflareプラットフォームに精通しており、すぐに使える個人用エージェントを求める開発者。

ライセンス – MIT。

---

上記の内容はすべてリポジトリのREADMEから直接引用しています。