Statewave
Open-source, self-hosted memory runtime that gives AI agents governed long-term memory with provenance and audit receipts
Statewave treats agent memory as infrastructure with an audit trail, not a retrieval shortcut, and that framing is the whole value. If your AI system has to answer "what did the agent know, and why," the provenance chain and byte-hashed state-assembly receipts are worth the self-hosting overhead — the vendor cites EU AI Act applicability from 2 August 2026 and high-risk logging obligations from 2 December 2027 as the deadline it's built for. Pass if you want a drop-in hosted memory API and don't care about policy enforcement or replayable context calls; Mem0 and Zep are the managed alternatives the project itself benchmarks against.
Verified 1d ago · liveness 76/100 · cite: rightaichoice.com/tools/statewave
- Developers building AI agents that must remember users, projects and prior sessions
- Support engineering teams needing session context, handoff packs, health scoring and SLA tracking
- Platform teams running self-hosted Postgres infrastructure
- Enterprises needing GDPR erasure and audit-ready memory with provenance and receipts
- Non-technical users who want a hosted, plug-and-play memory service
- Teams unwilling to self-host and operate their own Postgres-backed runtime
- Projects that only need simple key-value memory without compilation or governance
We scan live Reddit threads, YouTube comments, X posts, G2 reviews and other communities — and hand you an honest verdict in under a minute.
- Honest verdict, not marketing
- Real pros & cons from real users
- Attributed quotes with receipts
3 free scans · no card needed
Skip Statewave if you want a managed, hosted memory API and have no appetite for running Postgres and tuning a compilation pipeline yourself.
Running it self-hosted means you pay for the Postgres instance, deployment hardware and on-call time — the Apache 2.0 license is free but the runtime is not free to operate.
Statewave is free under Apache 2.0, so its real cost is infrastructure plus the engineering time to run Postgres and tune compilation — typically cheaper than hosted memory APIs like Mem0 or Zep at high volume, but only if you already operate your own services. For a small team without platform capacity, a managed alternative will cost more per month and less per engineer.
In short
Statewave — Open-source, self-hosted memory runtime that gives AI agents governed long-term memory with provenance and audit receipts. Best for Developers building AI agents that must remember users, projects and prior sessions, Support engineering teams needing session context, handoff packs, health scoring and SLA tracking, Platform teams running self-hosted Postgres infrastructure. Free to use.
What's new in Statewave
Checked yesterdayAcross the latest 5 updates: 5 news mentions.
Statewave compares six open-source Mem0 alternatives
The team publishes a comparison of six open-source alternatives to Mem0, citing Mem0's self-hosted build as lacking graph memory, webhooks and audit logs.
Statewave publishes explainable customer health score for support agents
An engineering post details how Statewave computes an explainable customer health score, why it drifts on quiet days, and how a handoff context pack stays under a token budget.
Statewave argues session state beats more memory for AI support agents
The post covers scoring weights and the repeat-issue rule for a session-aware support agent that ranks context by ticket state rather than similarity.
Statewave details repeat-issue detection scoring for support automation
Repeat-issue detection is described in detail: a resolved session carries a -5.0 ranking penalty, and detection adds +4.0, or +6.0 with a summary.
Statewave explains idempotent compilation and conflict resolution
The post details Statewave's mechanism for idempotent memory recompilation and for resolving genuinely conflicting events without duplicating or corrupting stored memory.
What people actually say about Statewave — is it worth it?
We ran a structured research pass across product reviews, community discussions, and post-purchase forum threads to surface the patterns vendors won't publish themselves. Below: the recurring strengths, the hidden costs people mention most, and the cohort that consistently regrets adopting this tool.
9 mentions across 2 sources (Product Hunt, GitHub) · researched Aug 13, 2026.
Average across the 2 sources that answered — each source counts once, not each post.
- +Full provenance: every retrieval traces back to a source.
- +Supersession model archives conflicting agent state instead of dropping it.
- +Access control and audit trail built-in — no custom governance layer.
- +Self-hosted on Postgres + pgvector; data stays on your infra.
- +Apache-2.0 open source with Python and TypeScript SDKs.
- −Requires Postgres + pgvector knowledge — not a plug-and-play service.
- −Admin console might lack manual memory inspection or editing.
- −No managed hosted version confirmed yet.
- −Small user base; limited mainstream community proof.
- −IDE Companion still in pre-market validation, not yet published.
- • Infrastructure costs: Postgres and pgvector servers, storage, and maintenance
- • No official managed hosting confirmed, so any managed option may come later with separate pricing
Viability Score
How well maintained and how widely used is Statewave? Built from what the vendor actually publishes (docs, changelog, tutorials, integrations, pricing), whether the site is live, and how much real users discuss it. How we calculate this
Last calculated: September 2026
How we score →Key Features
- Ingest raw events as immutable episodic memories
- Compile episodes into typed memories with confidence scores, idempotent on re-run
- Retrieve ranked, token-bounded context bundles at 512, 1024, 2048 or 4096 tokens
- Trace every compiled memory back to its source episodes with full provenance
- Tag memories with pii, financial or secret sensitivity labels, auto-detected at ingest
- Gate memory access with declarative YAML policies per tenant and caller identity
- Emit immutable ULID-addressable state-assembly receipts with a byte-level integrity hash
- Multi-tenant isolation via subject-scoped architecture and app-layer query isolation
- GDPR-ready subject erasure across episodes, memories and receipts in one call
- Organize memory around subjects: users, accounts, agents, repos
- Auto-configure MCP servers for Claude Code, Claude Desktop, Cursor, VS Code Copilot and Codex CLI
- Support workflow: session-aware context, handoff packs, customer health scoring, SLA tracking, repeat-issue detection
- Run locally with one npx command, no account, offline
- REST API with Python and TypeScript SDKs
- log_only policy mode to audit enforcement decisions before enabling them
About Statewave
Statewave is an open-source, self-hosted memory runtime for AI agents that need to remember across sessions. Rather than dumping chat logs into prompts or leaning on a bare vector store, it records raw events as immutable episodes, runs a background compilation pass that produces typed, durable memories with confidence scores, and returns ranked, token-bounded context bundles (the benchmark suite exercises 512, 1,024, 2,048 and 4,096 tokens). The episodic/semantic split follows the 2023 CoALA framework for language agents; recompilation is idempotent, so re-runs never duplicate memories. Everything is organized around subjects — users, accounts, agents, repos — with multi-tenant isolation at the tenant boundary. What separates it from a memory library is governance: sensitivity labels (pii, financial, secret) auto-detected at ingest and operator-reviewed before promotion, YAML policies that gate access by caller identity with a log_only audit mode, and immutable ULID-addressable state-assembly receipts with a byte-level integrity hash so you can replay exactly what the agent saw. Subject deletion wipes episodes, memories and receipts in one call for GDPR erasure. One npx command boots the runtime locally — API, admin console and Postgres — with no account required, and auto-wires into MCP clients including Claude Code, Claude Desktop, Cursor, VS Code Copilot and Codex CLI. Connectors pull events from GitHub, Slack, Zapier, n8n and Zendesk. The core repo ships 708 unit tests and 56 eval assertions across the record → compile → retrieve path. It's aimed at developers and platform teams running stateful AI: support agents, coding agents and internal copilots.
Behind the Verdict
Statewave's bet is that retrieval is now a commodity and governance is not. The architecture reflects that: raw events land as immutable episodes, a background compilation pass turns them into typed memories with confidence scores, and every context call emits an immutable, ULID-addressable receipt carrying a byte-level integrity hash. That receipt is the piece competitors rarely ship — it lets you replay exactly what an agent saw at a point in time, which is precisely the artifact an auditor asks for. Strengths. The episodic/semantic split is grounded in the 2023 CoALA taxonomy rather than invented ad hoc, and compilation is idempotent, so re-running it never duplicates memory. Sensitivity labels (pii, financial, secret) are auto-detected at ingest but held for operator review before promotion, and the YAML policy engine ships a log_only mode so you can watch access decisions for a while before you enforce them. Multi-tenancy is subject-scoped with app-layer query isolation, and subject erasure clears episodes, memories and receipts in a single call — the GDPR story is a first-class API, not a support ticket. The engineering is documented rather than implied: 708 unit tests and 56 eval assertions across record → compile → retrieve, plus a scoring model the team publishes openly (a resolved session carries a -5.0 ranking penalty; repeat-issue detection adds +4.0, or +6.0 with a summary). Weaknesses. You run it. That means Postgres, deployment sizing, capacity planning, and the tenant-boundary backfill step the team warns silently erases memory if skipped. The connector surface shown in the scrape is GitHub, Slack, Zapier, n8n, Zendesk plus MCP and docs/markdown sources — broad enough for support and coding workflows, but this is not a tool that wires itself into every SaaS you own. The reference benchmark of 73% fewer tokens versus raw history comes from the vendor's own demo, not an independent evaluation. Pricing visible today is a single free Apache 2.0 tier, so budget for your own infrastructure and operations rather than a subscription. Where it fits. Teams running support agents that need session context, handoff packs, health scoring, SLA tracking and repeat-issue detection — the vendor's own "primary wedge" — and coding agents that should accumulate tech stack, architecture decisions and preferences across sessions. Any system where compliance asks for traceability of what was remembered and what was selected into a prompt. Where it doesn't. Non-technical buyers wanting a hosted plug-and-play service, teams that won't operate Postgres, and projects whose recall problem a nearest-neighbor vector lookup already solves. If you need managed convenience more than provenance, Mem0 and Zep are the honest comparisons.
Researching Statewave? Get your full AI stack in 60 seconds.
Free, no signup — tell us your goal and get tools matched to your budget & existing stack.
Real-world workflow fit
Concrete scenarios for the personas Statewave actually fits — and what changes day-one when you adopt it.
You wire the one-line npx install into your support agent, connect the Zendesk and Slack connectors so tickets and threads land as episodes, and run a compile pass that turns them into durable profile facts and prior-issue summaries.
Outcome: Your agent opens each ticket with the customer's history and preferences already in context, flags repeat issues using the vendor's published scoring, and emits a byte-hashed receipt you can hand to compliance.
You boot Statewave locally with npx, let it auto-configure the MCP server for Cursor, and point the GitHub connector at the repos the agent works in so tech stack and architecture decisions become typed memories.
Outcome: Each new session starts with project context and past decisions instead of a blank slate, and you can trace any memory the agent used back to the commit or document it came from.
You deploy Statewave on your own Postgres, set YAML policies per tenant and caller identity, and run them in log_only mode for the first weeks while you watch which access calls would have been blocked.
Outcome: You move to enforced policies once the audit log looks right, and subject erasure for GDPR becomes a single API call that clears episodes, memories and receipts together.
Use Cases
- Build AI support agents that carry session context, resolution history and handoff packs across conversations
- Run coding agents that accumulate project knowledge — tech stack, architecture decisions, preferences — over time
- Give internal copilots persistent memory of user workflows, past decisions and organizational context
- Detect repeat issues automatically, with a -5.0 ranking penalty on resolved sessions and +4.0 for a detection
- Assemble handoff context packs that fit a fixed token budget for a live support queue
- Keep an audit trail of what each agent saw via immutable state-assembly receipts
- Satisfy GDPR erasure requests by wiping episodes, memories and receipts for a subject in one API call
- Operate multi-tenant memory with per-tenant policy enforcement and app-layer query isolation
Limitations
- Statewave is a runtime you operate, not a service you subscribe to.
- That means running Postgres, sizing deployment hardware and working through the capacity-planning and tuning checklist as load grows.
- The project's own docs flag a tenant-boundary backfill step that silently erases memory if skipped — a migration footgun worth reading before you move tenants.
- Recall quality depends on getting the compilation pass and token budget tuned to your system; there is no managed control plane doing that for you.
- The 73% token-reduction figure comes from the vendor's reference demo rather than an independent benchmark.
- The only pricing tier visible in the scrape is the free Apache 2.0 self-hosted tier, so infrastructure and operational cost sit with you.
- Treat this as an emerging open-source project and budget evaluation time before it holds production state.
as of 2026-09-28
Verification history
We have re-verified Statewave 5 times since . Each pass re-reads the vendor's own pages and re-checks every listed field against that evidence; passes where nothing had changed are marked as such.
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-checked, vendor evidence unchanged
- — re-checked, vendor evidence unchanged
- — re-checked, vendor evidence unchanged
Free to cite with attribution — this page re-verifies continuously.
12-month cost
Project the real annual outlay, including the implied monthly cost when only an annual tier is published.
Vendor list price only. Add-on usage, seat overages, and contract minimums are surfaced under Hidden costs & gotchas.
Plans compared
For each published Statewave tier: who it actually fits, and what it adds vs. the previous tier. Cross-reference the cost calculator above for projected annual outlay.
Open Source (Apache 2.0)
$0
Ideal for
Developers and platform teams who can run Postgres themselves and want governance, provenance and audit receipts without a per-seat subscription.
What this tier adds
Starting tier, and the only one shown: $0 for the self-hosted runtime, API, admin console, sensitivity labels, YAML policies, receipts, connectors and SDKs under Apache 2.0.
Where the pricing makes sense
The company stage and team size where Statewave's pricing actually pencils out — and where peers do it cheaper.
Statewave is free under Apache 2.0, so its real cost is infrastructure plus the engineering time to run Postgres and tune compilation — typically cheaper than hosted memory APIs like Mem0 or Zep at high volume, but only if you already operate your own services. For a small team without platform capacity, a managed alternative will cost more per month and less per engineer.
Setup time & first value
How long it actually takes to get something useful out of Statewave — broken out by persona, not the marketing-page minute.
One npx command boots API, admin console and Postgres with no account, so a developer can see the comparison demo in minutes. The manual git clone plus docker compose up -d path documented in Getting Started runs about 5 minutes. The vendor's design-partner onboarding is pitched as a 30-minute setup with an evaluation checklist, which is the realistic timeline for a team wiring connectors,
Switching to or from Statewave
How to bring data in from common predecessors and how to get it back out — written for the switcher, not the buyer.
- →From prompt-stuffed chat history: replay past sessions into Statewave as episodes, then compile and retire full-history prompts in favor of token-bounded bundles.
- →From a bare vector store: keep the store for document search and route session memory through Statewave's episodic ingest, compilation and receipts.
- →From Mem0 self-hosted: port memory records in as episodes and let compilation produce typed memories with the provenance the project says Mem0's self-hosted build lacks.
- →From raw log archives: use the GitHub and Markdown connectors to normalize existing events into episodes instead of hand-writing import scripts.
- ↗To a hosted memory API (Mem0, Zep): export compiled memories and episodes, then rebuild retrieval against the managed endpoint — you lose the state-assembly receipts.
- ↗To prompt-stuffed history: only viable at small scale, and reverses the token savings since history replays in full on every call.
- ↗To an in-house memory layer: the docs repository publishes the architecture docs, API v1 contract and ADRs, so a rebuild can follow the same subject and receipt model.
Integrations
Resources & Guides
- Resourcegithub.com
Statewave Docs · Statewave
Helpful link from github.com
- Quickstartgithub.com
Getting Started · Statewave
Get up and running fast from github.com
- Resourcegithub.com
Troubleshooting · Statewave
Helpful link from github.com
- Resourcegithub.com
Why Statewave · Statewave
Helpful link from github.com
- Resourcegithub.com
Subject Design · Statewave
Helpful link from github.com
- Resourcegithub.com
Sensitivity Labels · Statewave
Helpful link from github.com
- Resourcegithub.com
Receipts · Statewave
Helpful link from github.com
- Resourcegithub.com
Roadmap · Statewave
Helpful link from github.com
- API Referencegithub.com
Api · Statewave
Methods, params, types from github.com
- Resourcegithub.com
Architecture · Statewave
Helpful link from github.com
Tutorials & Learning
YouTube returned 6 videos for “Statewave”, and we withheld 6: 6 could not be judged, because “Statewave” is a single word that other videos use for other things. We are showing none, because we could not prove any of them are about Statewave.
Official links
Tools that pair well with Statewave
Common stack mates teams adopt alongside Statewave, with the specific reason each pairing earns its keep.
Agentmemory
Open-source persistent memory runtime that gives AI coding agents long-term memory across sessions, with zero external databases
Atomicmemory
Open-source, self-hosted memory engine that gives AI agents persistent, inspectable state with full audit trails.
Powermem
Open-source, self-hosted memory layer that gives AI agents persistent recall via hybrid retrieval.
Featured Head-to-Head Comparisons
Statewave vs Arcade Ai
Pick Statewave if your bottleneck is agents forgetting context and you want to self-host a memory layer you fully control. Pick Arcade AI if your bottleneck is securely connecting agents to real user accounts and enterprise tools — it ships auth, governance, and a huge MCP catalog out of the box. Most teams shipping production agents today will find Arcade's faster time-to-value worth the trade-off, unless you have a very specific memory-heavy use case.
Statewave vs Tobira
If you're building agents that need to be found and communicated with by humans and other agents across the open web, start with Tobira — it's free and gives you instant public identity. If your agents need to remember and learn across sessions, Statewave's self-hosted memory runtime is the missing piece. Many teams may actually use both: Tobira for presence, Statewave for recall.
Statewave vs Mem0
If you need a battle-tested memory layer with compliance (HIPAA, SOC 2) and deep framework integrations, Mem0 is the clear choice—especially for regulated industries. But if you're a startup that values open-source flexibility and want to self-host without vendor lock-in, Statewave offers a lean, customizable runtime. Choose based on whether you prioritize compliance and ecosystem (Mem0) or open-source control (Statewave).
Alternatives to Statewave
View allAgentmemory
Open-source persistent memory runtime that gives AI coding agents long-term memory across sessions, with zero external databases
Atomicmemory
Open-source, self-hosted memory engine that gives AI agents persistent, inspectable state with full audit trails.
Frequently Asked Questions
Categories
Topics
Used Statewave? Help shape our editorial sentiment research.