JasonLiu0826/ackem

Ack — Windows向けのローカルファーストAIコンパニオン

概要 – Ackem (Autonomous Companion Keeping Emotional Memory) は、Electronで構築されたWindows専用のデスクトップアプリケーションです。OpenAI互換の言語モデル（OpenAIやDeepSeekなどのクラウドサービス、またはOllama/LM Studioなどのローカルサーバー）を接続し、チャットや過去の会話の記憶、感情・関係性の追跡、さらにはシステムトレイアイコンやデスクトップペットとして表示される永続的な「友人」を提供します。

主な機能

• チャット – 設定されたLLMにプロンプトを送信し、チャットウィンドウに応答を表示します。
• 構造化メモリ – すべての会話はローカルに保存され、埋め込み (embeddings) でインデックス化されて検索可能です。また、タイムラインやナレッジグラフとして視覚化できます。プレーンテキスト (.txt) や Markdown (.md) ファイルを長期的なコンテキストとしてインポートすることも可能です。
• コンパニオンの状態 – アプリは信頼度、気分、関係性の段階、日記を保持します。性格プリセットやプロアクティブなメッセージにより、「コンパニオン」がより生き生きと感じられます。
• デスクトッププレゼンス – システムトレイアイコン、幾何学的なオーブやLIVE2Dペット、音声STT/TTS（オプション）に対応しています。
• 拡張機能 – 拡張センター (Extension Center) を通じて、開発者がプラグイン（WeChatブリッジ、ゲームモード統合、カスタムスキルなど）を追加できます。
• ローカルファーストデータ – すべてのチャット、メモリ、APIキー、設定は Ackem.exe の隣にある data/ フォルダに保存されます。リリースzipにはユーザーデータは含まれておらず、テレメトリも送信されません。

はじめ方（エンドユーザー向け）

1. GitHubまたはGiteeのリリースページから green リリースzipをダウンロードします。
2. zipをSSD上のフォルダに解凍します（zip内から直接実行しないでください）。
3. Ackem.exe（または提供されているバッチファイル）を実行します。初回起動時に埋め込みモデルの展開が行われ、約10〜30秒かかります。
4. プライバシー/コンプライアンス画面に同意します。
5. Settings → Model & API を開き、使用したいLLMのベースURL、モデルID、APIキーを入力します。
6. チャットを開始します。メモリビューから .txt/.md ファイルをインポートして、コンパニオンに長期的な知識を与えます。

開発者向けメモ

• 本プロジェクトはViteベースのレンダラーを使用したElectronアプリです。開発にはWindows上でNode 20+が必要です。
• コアスクリプト：npm run dev（開発モードで実行）、npm run build（コンパイル）、npm run dist:green（ポータブル版の生成）、npm run dist:setup（NSISインストーラー）。
• アーキテクチャは7つの論理システム（Brain, Heart, Mouth, Neural, Extension, Timeなど）に分割されており、docs/developer/architecture/ にドキュメント化されています。
• コードベースにはTypeScriptの型チェック、ユニットテスト、SQLiteベースのデータレイヤーが含まれています。

プライバシーとデータ処理

• 公式リリースにはユーザーデータは一切含まれていません。初回実行後、すべてはローカルの data/ ディレクトリに保存されます。
• APIキーはローカルの設定ファイルにのみ保存され、Ackemサーバーへのテレメトリ送信は行われません。
• リポジトリには詳細なプライバシーポリシー (docs/privacy-and-data.md) が含まれています。

ステータス – 単一のメンテナーによって活発にテストされています。クラッシュやラグは稀ですが発生する可能性があります。予期しない動作についてはIssueを報告してください。

ライセンス – AGPL-3.0。個人、研究、オープンソース統合での使用は許可されています。商用またはクローズドソースのSaaS利用には別途商用ライセンスが必要です（READMEの連絡先を参照）。

---

上記の情報はすべて、リポジトリのREADMEおよびリンクされたドキュメントから直接引用しています。