statewave

開源 AI 代理記憶執行環境 — 可重現、附來源標記的上下文包,取代查詢時檢索。Apache-2.0,自架於 Postgres。

statewave 是什麼?

開源 AI 代理記憶執行環境 — 可重現、附來源標記的上下文包,取代查詢時檢索。Apache-2.0 授權,自架於 Postgres + pgvector,支援 Python 與 TypeScript SDK。

statewave 概覽

這是什麼

Statewave 是一個開源的 AI 代理記憶執行環境。它提供可重現、帶有來源標記的上下文套件,而非查詢時檢索。它自架於 Postgres 和 pgvector 之上,採用 Apache-2.0 授權。Statewave 不是聊天機器人框架、向量資料庫、RAG 管線或託管服務;它是與你的應用程式並行運作的基礎設施。

主要功能

  • 編譯上下文套件:依主題和任務排序、限制 token、確定性輸出。
  • 來源追蹤:每個記憶都可追溯到其來源事件;收據以內容雜湊。
  • 可插拔編譯器:啟發式(正則表達式,完全本地)或 LLM(任何 LiteLLM 提供者)。
  • 主題組織:user:、repo:、account: 或任何實體前綴。
  • 狀態組裝收據:不可變、ULID 可定址的記錄,記錄哪些記憶影響了每個套件,帶有 HMAC-SHA256 簽章和策略快照。
  • 敏感度標籤與策略引擎:宣告式 YAML 策略(deny / redact)套用於每個記憶的標籤,支援 log_only 和 enforce 模式。
  • 多租戶:透過 X-Tenant-ID 標頭進行查詢範圍的資料隔離,每個租戶的設定和策略,以及區域固定。
  • 自架於 Postgres + pgvector:無供應商鎖定。

使用情境

  • 客戶支援代理:跨工作階段識別回訪客戶,帶有 token 預算的排序上下文、來源追蹤、升級時的手動交接包。
  • 長期運行的編碼代理:多工作階段的專案記憶,用於技術棧、偏好和架構決策。
  • 無狀態與記憶增強代理:並排運行真實 LLM 的完整迴圈,以比較差異。
  • 框架整合:範例儲存庫中提供 LangChain、CrewAI 和 AutoGen 的即插即用整合。

快速開始

用一行指令執行伺服器: bash # macOS / Linux npx @statewavedev/statewave # 或 curl -fsSL https://www.statewave.ai/install | sh powershell # Windows (PowerShell) irm https://www.statewave.ai/install.ps1 | iex 或使用 Docker 自架: bash git clone https://github.com/smaramwbc/statewave && cd statewave docker compose up -d API 位於 http://localhost:8100。若要使用 LLM 支援的行為,請在 .env 檔案中設定 STATEWAVE_EMBEDDING_PROVIDER=litellm 及相關金鑰,然後重新執行 docker compose up -d。

授權與價格

Statewave 以 Apache-2.0 授權釋出為開源軟體。價格未說明;它是自架且開源的。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/smaramwbcstatewave.svg)](https://yunodb.com/tools/smaramwbcstatewave?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/smaramwbcstatewave?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/smaramwbcstatewave.svg" alt="Featured on YunoDB" height="20"></a>