Statewave

Statewave

Open-source, self-hosted memory runtime that gives AI agents governed long-term memory with provenance and audit receipts

76/100Safe BetFreeFree

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

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
  • Enterprises needing GDPR erasure and audit-ready memory with provenance and receipts
Not ideal for
  • 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
Visit Website

AdvancedOne 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,Web · API · CLIAPI availableVerified 1d ago
Pricing
Free
FreeFree tier6 hidden costs
Learning curve
Advanced
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,
Runs on
WebAPICLI
API available · 15 integrations
Who it's for
Support engineering leadDeveloper running a coding agent in CursorPlatform engineer at a regulated company
Live sentiment
Is Statewave actually worth it?

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
Run a free scan

3 free scans · no card needed

Skip it if

Skip Statewave if you want a managed, hosted memory API and have no appetite for running Postgres and tuning a compilation pipeline yourself.

The 30-second take
Biggest gripe

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.

Price reality

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 yesterday

Across the latest 5 updates: 5 news mentions.

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.

83% positive17% critical

Average across the 2 sources that answered — each source counts once, not each post.

Recurring strengths
  • +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.
Recurring frustrations
  • −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.
Patterns worth knowing
Provenance and auditability are the biggest differentiators — users love that every retrieval traces back to a source, solving their 'why did it use that memory?' problem.
Seen on Product Hunt, GitHub
The supersession model for conflicting agent state is a unique feature — archiving older memories as superseded with links to both versions.
Seen on Product Hunt
Self-hosting is both a strength (data control and governance) and a concern (users want a managed option to avoid ops burden).
Seen on Product Hunt, GitHub
Learning curve
intermediateProductive in ~A few hours
Hidden costs people mention
  • • 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

76/100
Safe Bet

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

Recent activity
90
Traction
90
Site health
95
User sentiment
83
What the vendor publishes
40

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

FreeAdvancedAPI availableWeb · API · CLI

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.

Support engineering lead

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.

Developer running a coding agent in Cursor

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.

Platform engineer at a regulated company

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

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.

  1. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  2. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  3. — re-checked, vendor evidence unchanged
  4. — re-checked, vendor evidence unchanged
  5. — 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.

Annual total
Free
Over 12 months
Effective monthly
—
—

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.

Hidden costs & gotchas

What the public pricing page doesn't put in bold. Captured from pricing-page footnotes, contract terms, and recurring complaints.

  • 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.
  • Skipping the tenant-boundary backfill during a multi-tenant migration silently erases memory, and recovery means re-ingesting the lost episodes.
  • Getting recall right takes tuning: the token budget is yours to set, and the docs treat capacity planning and re-tuning as a recurring chore as load grows, not a one-time setup.
  • Sensitivity labels are auto-detected at ingest but held for operator review before promotion — that review is ongoing human time, not an automated step.
  • Compilation introduces a background pass between ingest and retrieval, so fresh events are not instantly available as memories unless you trigger or wait for the compile.
  • Because the project publishes only a free open-source tier, any future paid hosting or managed offering means re-deciding between self-hosting and a bill.

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.

Migrating in
  • →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.
Migrating out
  • ↗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

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.

Tools that pair well with Statewave

Common stack mates teams adopt alongside Statewave, with the specific reason each pairing earns its keep.

Featured Head-to-Head Comparisons

Alternatives to Statewave

View all
Agentmemory

Agentmemory

Open-source persistent memory runtime that gives AI coding agents long-term memory across sessions, with zero external databases

FreeTry
Atomicmemory

Atomicmemory

Open-source, self-hosted memory engine that gives AI agents persistent, inspectable state with full audit trails.

FreemiumTry
Powermem

Powermem

Open-source, self-hosted memory layer that gives AI agents persistent recall via hybrid retrieval.

FreeTry

Frequently Asked Questions

Used Statewave? Help shape our editorial sentiment research.