本文へスキップ
ai-memory
EnglishPortuguês (Brasil)Españolעברית日本語한국어
メニュー

プロダクト

ソリューション

連携

開発者

言語

はじめるGitHub

開発者

クイックセットアップ

インストール、設定、エージェントの起動の順に進みます。1 台ならローカル構成、チームなら共有サーバーの手順を選んでください。

自分だけで使うチームで使う動作を確認する

自分だけで使う

バイナリを1つインストールし、ローカルサーバーを1つ起動させて、エージェントを立ち上げます。サーバーは127.0.0.1:49374にバインドするので、このマシンの外からは届きません。新規インストールではトークンが所有者専用のファイルに保存され、フックとCLIがそこから読むので、入力は不要です。

  1. バイナリをインストールする

    スクリプトがお使いのOSとチップに合ったリリースをダウンロードし、公開されている.sha256ファイルと照合します。一致しなければインストールしません。~/.local/bin/ai-memoryにリンクを作り、rootは要りません。

    ターミナル
    curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | sh

  2. セットアップする

    setup はデータディレクトリとトークンを作成し、ユーザーサービスを起動して選択したエージェントを接続します。変更せずに確認するには setup --plan、ローカルのブラウザページでエージェントを選ぶには setup --web を使います。

    ターミナル
    ai-memory setup

  3. ai-memory経由でエージェントを起動する

    エージェントを一度再起動してください。その後はclaudeを直接起動しても引き続き動作します。

    ターミナル
    ai-memory run claude

インストール

サーバーを起動

127.0.0.1:49374

エージェントを実行

hooks / MCP

個人向けの経路の全体像です。サーバーはループバックにとどまり、エージェントは2つの方法でつながります。フックがセッションをキャプチャし、MCPでエージェントがそれを検索します。

ai-memory runはエージェントを起動する方法です。初回起動時にハーネスを接続し、正しいプロジェクトスコープを選び、ハーネスをまたいだセッション再開を追加します。エージェントを直接起動した場合もフックによるキャプチャは続きますが、ランチャー経由なら取りこぼしがありません。マネージド起動の仕組みを読む。

動作を確認する

ネットワークからエージェントまで、下から順に3つ確認します。

サーバーが応答する

認証が有効な新規インストールでは、この認証なしのリクエストは HTTP 401 と「auth required」を返すはずです。確認できるのは到達性だけです。次の手順で CLI の認証付きアクセスを確認します。

ターミナル
curl -i http://127.0.0.1:49374/mcp

CLIがサーバーに届く

CLIは薄いHTTPクライアントです。ここでステータスが表示されれば、フックもサーバーに届きます。

ターミナル
ai-memory status

エージェントが覚えている

機密情報を含まないプロジェクトで、最初のエージェントに具体的な決定事項を保存させます。セッションを終了し、同じディレクトリで別の対応エージェントを起動して、その決定事項と根拠となる保存済みページを尋ねてください。

「保存したプロジェクトの決定事項と、それを記録した記憶のページを教えて」

最初のエージェントのあとで

3つとも任意です。必要になったときに行ってください。

別のエージェントを追加する

ai-memory経由で一度起動すれば、接続は完了します。これで両方のエージェントが1つのプロジェクト記憶を共有します。

ターミナル
ai-memory run codex

対応エージェントとその名前をすべて見る

任意：LLMで要約の質を上げる

記録、検索、ルールによる要約はプロバイダーなしで動きます。追加すると、詳しい要約と定期的な自動改善が有効になり、検証済みの編集が既定で自動適用されます。共有サーバーでは [auto_improve] require_approval = true を設定してください。以下の環境変数をサーバーに設定し、再起動します。

サーバーの環境変数
AI_MEMORY_LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...

サブスクリプションやローカルモデルも含めてプロバイダーを比較する

すべて元に戻す

削除されるのはai-memoryがインストールしたものだけです。インストールコマンドは冪等で、ファイルに手を加えるときは必ず、その隣にタイムスタンプ付きのバックアップを書き出します。

ターミナル
ai-memory uninstall --apply

チームで使う

すべてのマシンとすべてのチームメンバーがつながる1つのサーバーです。サーバー間のレプリケーションはありません。記憶の共有とは、全員が同じサーバーに接続することです。

alice

bob

carol

共有サーバー1台

トークン

チームで1つのwiki

1人に1つのAPIキー

wikiはサーバーが持ちます。人にはアカウント、マシンにはAPIキーを割り当て、rootトークンはサーバーの運用者が管理します。

  1. ローカルプロキシの背後でサーバーを起動

    まずサーバーホストにネイティブ CLI をインストールします。このコマンドは Docker をループバックにのみ公開し、このシェルの CLI に root 認証情報を設定します。memory.example.com を自分のドメインに置き換えてください。root トークンは共有せず、ノート PC には後で個別キーを発行します。

    サーバー上で
    ROOT_TOKEN=$(ai-memory generate-auth-token)
export AI_MEMORY_SERVER_URL="http://127.0.0.1:49374"
export AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN"
docker run -d --name ai-memory \
    --restart unless-stopped \
    -p 127.0.0.1:49374:49374 \
    -v ai-memory-data:/data \
    -e AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN" \
    -e AI_MEMORY_AUTH__SECURE_COOKIE=true \
    -e AI_MEMORY_ALLOWED_HOSTS="memory.example.com,localhost,127.0.0.1" \
    akitaonrails/ai-memory:latest

  2. クライアント接続前に TLS を設定・検証

    同じホストにリバースプロキシを置き、ドメイン宛ての HTTPS を 127.0.0.1:49374 に転送します。TLS の設定手順に従い、キーを送る前にノート PC から証明書を検証してください。Bearer トークンは認証を行いますが、通信を暗号化しません。

  3. メンバーを作成する

    root の環境変数を設定したサーバーのシェルを使います。一時パスワードは一度だけ表示され、初回ログイン時に変更が必要です。このコマンドでは API キーは発行されません。root の識別とブラウザーログインの設定はユーザーガイドを参照してください。

    ターミナル
    ai-memory user add-human --username alice --email alice@home --name "Alice Smith"

  4. 各メンバーにAPIキーを渡す

    aim_のシークレットは1回だけ表示されます。ai-memory api-key rotate <id>とai-memory api-key revoke <id>は即座に反映されます。

    ターミナル
    ai-memory api-key add --username alice --label codex-laptop

  5. 各マシンをサーバーに向ける

    各ノート PC に CLI をインストールします。以下のドメインとキーを HTTPS エンドポイントと本人に発行したキーに置き換えてください。Unix ではフックのインストーラーがトークンを所有者専用ファイルに保存し、生成したフックコマンドには含めません。--as-user はインストールのラベルであり、権限を付与しません。

    すべてのノートPCで
    # プレースホルダーをこの人に発行した aim_ キーに置き換えてください。ROOT_TOKEN は使わないでください
USER_API_KEY='aim_REPLACE_WITH_ISSUED_KEY'
export AI_MEMORY_SERVER_URL="https://memory.example.com"
export AI_MEMORY_AUTH_TOKEN="$USER_API_KEY"

ai-memory install-mcp   --client claude-code --apply
ai-memory install-hooks --apply --agent claude-code \
    --as-user alice --auth-token "$USER_API_KEY"

# あとはいつもどおり起動する
ai-memory run claude

続けて読む

どこかの手順で詰まりましたか？

GitHubのインストールクックブックに、エージェントごとのコマンド、リモートサーバー、Windowsの手順があります。Issueトラッカーも開いています。

今すぐインストールGitHubでスターする