smaramwbc/statewave

Open-source memory runtime for AI agents — reproducible, provenance-tagged context bundles instead of query-time retrieval. Apache-2.0, self-hosted on Postgres + pgvector, Python + TypeScript SDKs.

解決する課題

Statewaveは、セッション間でのコンテキストの喪失を防ぐ耐久性があり構造化されたメモリランタイムをAIエージェントに提供します。脆弱で非構造的なプロンプト詰め込みや単純なベクトルデータベースの検索を、エージェントが好み、意思決定、履歴を異なる会話間で記憶できる決定論的なシステムに置き換えます。

動作方法

Statewaveは「コンパイルしてから使用する」アプローチでアプリケーションと並行して動作するインフラとして機能します：

  1. インジェスト：生のイベント（エピソード）が追加のみ可能な形式で記録されます。
  2. コンパイル：これらのエピソードは、信頼度スコアと出典を伴う型付きで要約されたメモリに処理されます。
  3. リトリーブ：システムは必要に応じてランク付けされた、トークン制限付きのコンテキストバンドルを構成します。
  4. ガバナンス：対象のタイムラインの検査や、対象ごとのデータ削除が可能になります。

このプロセスは同一性（idempotent）であり、同じ対象に対して同じ時点での同じクエリを実行すると常に同じ結果が得られるため、クエリ時検索で一般的に見られるサンプリングノイズを排除します。

対象ユーザー

複数のセッションにわたってユーザー固有のデータやアーキテクチャ的決定を記憶できるようにしたいAIエージェント（例：カスタマーサポートや長期間実行されるコーディングエージェント）を開発する開発者。

特徴

  • 出典追跡：コンテンツハッシュされたレシートにより、すべてのメモリが元のソースエピソードに追跡可能。
  • 決定論的コンテキスト：対象およびタスクごとに一貫性のあるトークン制限付きバンドルを提供。
  • プラグイン可能コンパイラ：ローカルヒューリスティックコンパイラ（正規表現）とLiteLLMを介したLLMベースコンパイラの両方をサポート。
  • セルフホスト：Postgresとpgvector上で動作し、ストレージの所有権を確保しベンダー依存を回避。
  • マルチテナント対応：クエリスコープでのデータ隔離とリージョンピンニングによるデータ所在制御をサポート。
  • フレームワーク非依存：LangChain、CrewAI、AutoGenを含む任意のAIスタックとREST APIまたはSDK経由で統合可能。

関連

  • プロジェクト
    Atmosphere/atmosphere

    Atmosphere は、JVM ベースのフレームワークで、AI エージェントをアノテーション付きの Java クラスとして記述できます。リアルタイムストリーミング（WebSocket、SSE、gRPC、オプションの HTTP/3）、永続メモリ、ポリシー駆動のガバナンス、人間による承認、多くの LLM プロバイダー向けのアダプターを提供します。エージェントは、コードを書き直すことなく、ブラウザ、Slack、Discord、MCP、A2A などに公開できます。

  • プロジェクト
    LeoYeAI/talewell

    Talewellは、GitベースかつMarkdown形式のAIエージェント向け長期記憶システムです。各記憶レコードをバージョン管理されたファイルとして保存し、決定論的なオフラインでの呼び出しを提供します。また、データの来歴を強制し、ポータブルなAMPプロトコルを公開しているため、あらゆるエージェントプラットフォーム（OpenClaw、Claude Code、Codexなど）がプラグインやシンプルなファイル規則を通じて同じ記憶リポジトリを利用できます。

  • プロジェクト
    rtk-ai/icm

    ICM は、AI コーディングエージェント向けの Rust ベース、SQLite バックエンドのメモリシステムです。LLM 呼び出しなしでプロジェクト固有の事実を保存・想起でき、キーワードまたは埋め込みベースの検索をサポートし、多くのコーディングアシスタントと統合し、より大規模なサービスに匹敵するベンチマーク精度を達成します。

  • プロジェクト
    basicmachines-co/basic-memory

    共有MarkdownファイルとModel Context Protocol (MCP) を使用して長期的なナレッジグラフを作成する、AIアシスタント向けの永続的な双方向メモリシステム。

  • プロジェクト
    yuruotong1/autoMate

    autoMateは、AIチャットクライアントに永続的な個人用ストレージ（ノート、ファイル、リマインダー、長期記憶）と現実世界のアクションツールボックス（シェル、ブラウザ、SaaS API）を提供するローカルホストサービスです。MCP-over-HTTPブリッジ経由でクライアントと通信し、OpenClaw、Claude Desktop、Cursor、Clineなどに対応。独自のWebチャット、Chrome拡張、Dockerコンテナ、バイナリでも利用可能です。