Release Notes

Notable changes to the FishMem engine, hosted cloud, SDKs, and documentation. Dates are in UTC. For the engine's full commit history, see github.com/fishmem-labs/fishmem.

2026-08 — FishMem 0.2.0

• Desktop recovery: export a portable namespace backup and restore the complete local library with format validation and automatic rollback.
• Desktop release evidence: the packaged macOS app now waits for local embeddings and exercises add, search, get, update, history, and delete through the embedded CLI before an artifact is accepted.
• Release provenance: Desktop manifests record the source commit; hosted deployments pin the open-core revision and record the Cloud source revision.
• Security hardening: patched dependency lines, fail-closed self-host secrets, Cloud security headers, required Worker secrets, and removal of unused macOS privacy/transport exceptions.
• Documentation: expanded guides for operations, source RAG, scope and filters, organizations, portability, security, production rollout, integrations, and evaluation.

2026-08 — Python SDK 0.1.0

• PyPI release: the official Python distribution is now available as fishmem for Python 3.10 and newer; install it with pip install fishmem and import it with from fishmem import FishMem.
• Typed sync and async clients: the release includes FishMem, AsyncFishMem, and FishMemDesktop, plus the py.typed marker for type checkers.
• Trusted publishing: releases are built and published from GitHub Actions through PyPI's short-lived OIDC flow; no long-lived PyPI upload token is required.

2026-07 — Async inference and source RAG

• Breaking API: inferred POST /v1/memories writes now require Idempotency-Key and return HTTP 202 with a durable event_id; already distilled infer:false writes remain synchronous.
• Event API: GET /v1/events and /v1/events/{id} expose inference status, bounded retries, timing, refined records, and terminal errors without returning the original conversation or internal task payload.
• First-party SDKs: TypeScript and Python add addAsync/add_async, addAndWait/add_and_wait, and Event list/get/wait resources.
• Dashboard and Cloud billing: memory-inference tasks are visible in Operations; credits reserve at enqueue, settle once on success, and refund once after terminal failure.
• Source RAG: immutable file uploads, durable Docling extraction, retained originals, citation-ready chunks, and permanent source-family deletion are available across Cloud and self-hosted deployments.

2026-06 — Public launch

• FishMem Cloud is live at fishmem.com: a managed REST API, dashboard, API keys, usage metering, webhooks, and Stripe billing.
• fishmem engine open-sourced under Apache-2.0 at github.com/fishmem-labs/fishmem — hybrid graph + vector recall with bi-temporal facts.
• Benchmark harnesses published with frozen configuration and item-level reports. Treat those results as reproducible project evidence, not a guarantee for a different provider, dataset, or production workload.
• Documentation site launched at docs.fishmem.com covering the cloud, the open-source engine, cookbooks, integrations, agent plugins, and the full API reference.

Conventions

• Engine changes affect both self-hosted fishmem and the cloud.
• Cloud changes affect only the hosted platform.
• Breaking changes are called out explicitly and, on the cloud, are versioned so existing API clients keep working.