afair

あなたが使うAIはそれぞれ、あなたの異なるバージョンを記憶しています。あるAIが学んだことは、次のAIを開くときには消えているため、別のセッションを始めるたびに同じ決断、人間関係、好み、経歴を繰り返すことになります。

afair はそれらに共有の保管庫を与えます。これは Model Context Protocol (MCP) を通じて接続するため、同じメモリを Claude、あなたのコーディングエージェント、そして次に使うどんなツールでも利用できます。

成長するメモリは通常、もう一つの管理対象になります。afair はその手間を省きます。バックグラウンドエージェントがあなたのツールが記録した内容を読み、関連するものを発見し、有用な理解を最新に保ち、古いノイズを注意の対象から遠ざけます。構造は固定テンプレートではなく、あなたの生活に従います。ファイルへの整理、タグ付け、キュレーションは不要です。

結果は可視化されたままです。afair がどのように認識しているかを読んだり、その情報をソースまでたどったり、誤っている場合は修正したりできます。修正は履歴の一部となり、静かに置き換わることはありません。

そこに収められるのは、あなたの生活のすべてです。仕事、愛する人々、そしてAIに自然に知ってほしい個人的な事柄も含まれます。

データは追記専用であり、あなたのものです。afair はオープンソースでシングルテナントであり、いつでもすべてをエクスポートできます。名前は「私が覚えている限り」の略であり、それが不要になるように設計されています。

2つの利用方法

自分で実行する。 このリポジトリが全体であり、AGPLv3です。自分のマシンやサーバーでセルフホストすれば、すべてのレイヤーをエンドツーエンドで所有できます。それは無料で、永遠にです。クイックスタートは以下にあります。

または afair.ai に実行を任せる。 専用の隔離されたEUインスタンス、バックアップ、エクスポート、アップデートを代行するマネージドホスティングが近日登場します。afair.ai で早期アクセスリストに登録してください。

どちらの場合も同じコードです。ホステッド製品はこのリポジトリのデプロイの一つであり、別のプロプライエタリなフォークではありません。

Related MCP server: Hippocampus

3つのコマンド

afair が公開するツールは正確に3つで、将来にわたって変更されません：

• remember は、決断、重要な人物、見逃せない日付、好みなど、永続的なものを保存します。

• recall は、その瞬間に関連する情報を引き出します。

• observe は、AIが行ったことを記録し、保管庫を最新に保ちます。

AIに短いセットアップスニペットを渡せば、AIは自動的にこれらを呼び出します。呼び出しによって入れられない限り、何も保管庫に到達しません。

自分で実行する

Python 3.12以上とuvが必要です。

uv sync
cp .env.example .env
# add ANTHROPIC_API_KEY, or a key for any other provider (the model is yours to pick)
uv run python -m afair

サーバーは http://127.0.0.1:8765 で起動します。CLIまたはデスクトップクライアント（Claude Code、Codex、Cursor、GitHub Copilot）をそこに向けて接続すれば完了です。クラウドで動作するWebクライアント（Claude.ai、ChatGPT）では、代わりに公開HTTPSデプロイと簡単なOAuth設定が必要です。詳しくは docs/self-hosting.md を参照してください。すべての環境変数は .env.example にインラインで文書化されています。クライアント別の接続ガイドは docs/clients にあります。afair はデフォルトで個人向けですが、2つの環境変数を使用することで、保管庫を単一の組織（1つのインスタンス、1つのチーム）に属させることもできます（docs/self-hosting.md を参照）。

コーディングエージェントでインストールする

Claude Code、Codex、または他のコーディングエージェントをすでに使っていますか？ 以下のプロンプトを渡すと、エージェントが自動的にセットアップします：クローン、依存関係、設定、MCP配線、そしてラウンドトリップの検証まで行います。

このマシンに afair（オープンソースMCPメモリサーバー、 https://github.com/afairai/afair）をセットアップし、このツールを接続してください。 クローンし、uv sync を実行し、.env.example を .env にコピーし、LLM プロバイダーのAPIキーをそこに置くよう私に尋ねてください。次に実行するのは uv run python scripts/install_clients.py で、私のMCPクライアントを配線し、 afairの指示スニペットを追加します。サーバーを起動するコマンド （uv run python -m afair）と、それを実行し続ける方法を教えてください。起動したら、 テスト用の事実を remember し、それを recall して動作することを確認してください。docs/self-hosting.md と docs/clients/ に従ってください。APIキーは .env にのみ置き、他の場所には置かないでください。

これはローカルで実行され、CLIおよびデスクトップクライアントをそのまま利用できます。Webクライアント（Claude.ai、ChatGPT）に到達するには、docs/self-hosting.md の公開デプロイに関する注意事項に従ってください。

AIに使い方を教える

サーバーへの接続は半分にすぎません。もう半分は、AIが自らツールを使うようにすることです。短い指示スニペットをクライアントの永続的な指示（CLAUDE.md、AGENTS.md、カスタム指示、または .cursorrules）に貼り付けると、会話の開始時にコンテキストを思い出し、永続的なものを記憶し、自分の行動を観察します。毎回プロンプトを出す必要はありません。同じスニペットがすべてのクライアントで機能します。Claude Code、Codex、Cursorの場合、scripts/install_clients.py が接続設定とスニペットの両方を書き込みます。GitHub Copilotの場合は、接続設定を書き込み、リポジトリごとのスニペット手順を表示します（Copilotはワークスペースごとに指示を読み取ります）。

対応クライアント

Claude Code、Claude.ai、ChatGPT、Codex CLI、Cursor、Windsurf、Copilot、および Streamable HTTP 上で MCP をサポートするその他すべてのツール。

アーキテクチャ

• 基盤. FTS5 と sqlite-vec を備えた追記専用 SQLite。コンテンツアドレス方式です。ログが書き換えられることはありません。

• 解釈. 基盤上に構築されたバージョン管理されたビュー。保存済みのイベントに触れることなく再生成できます。

• MCP サーフェス. バージョン管理され、追加型です。一度リリースされた署名は動き続けます。

• エージェント. バックグラウンドワーカーが証拠を抽出し、関連するものを発見し、引用付きの生きた総合情報を維持します。クラスタ名と境界は証拠の変化に応じて変わります。ユーザーがカテゴリを定義することはありません。

完全な設計と、それを支える8つの不変条件は VISION.md にあります。理由を知りたいなら、そこから始めてください。

ドキュメント

コントリビューション

プルリクエストを歓迎します。セットアップ、通過すべきチェック、変更が壊してはならない不変条件については CONTRIBUTING.md を参照してください。セキュリティの問題を見つけましたか？ SECURITY.md を参照し、非公開で報告してください。

ライセンス

afair は GNU Affero General Public License v3.0（LICENSE）の下で公開されています。セルフホスト、フォーク、変更は自由に行えます。変更したバージョンをネットワークサービスとして他人に提供する場合、その変更を同じライセンスの下で公開する必要があります。afair.ai のホステッドサービスは、このコードのひとつのデプロイであり、別のプロプライエタリなフォークではありません。

一言で言えば：無料で使え、自分でホストでき、他人へのサービスとして実行する場合は共有が求められます。

ドイツ製

ドイツで開発されています。ホステッドインスタンスはEU内で稼働し、EUの法域に属します。