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 與儲存庫資訊。