What's new in 1.0
obsei 1.0 is a rewrite of the 0.0.x library: a self-hosted pipeline that redacts personal data at ingest, labels and groups feedback into themes, and sends what matters to your tools. Coming from 0.0.x, start with the migration guide. Every change is in the changelog.
Highlights
Section titled “Highlights”- A short first run.
obsei initwrites the project, sample data with synthetic PII and.obsei/secrets.env.obsei trypreviews redacted, labelled records from the project or from any public link or file, without storing anything (Quickstart). - An in-process classifier by default.
api: localruns bge-m3-zeroshot-v2.0 on your machine withobsei[local]; no model server is needed.themes.embedder: autopicks the multilingual embedder whenobsei[embeddings]is installed (Models). - Measure and correct.
obsei evalscores the classifier on a labelled CSV and suggests cutoffs,obsei correctstores human labels, andobsei reprocessrelabels stored records (Classify). - Setup without YAML.
obsei add,obsei checkandobsei integrations, field descriptions everywhere, and a published JSON Schema for editor completion (Set up without editing YAML). - Alerts. Theme spikes, new themes, digests, review-queue size and pipeline health, with cooldown, snooze and acknowledge (Alerts).
- Signed events and notifications. The
webhooksink sends CloudEvents signed per Standard Webhooks, retries and logs deliveries; thenotifysink reaches Telegram, Discord, email and 100+ services (Sinks). - Safer agents. MCP results mark customer text
untrusted, andpropose_issuequeues issues forobsei approvals approve(MCP). The MCP server is part of the core package, and plugins for Claude Code, Codex, the Copilot CLI and Gemini CLI install it from the GitHub repository (AI tools). - Connector status. Each source and sink is marked
verified(a live test against the real service) orbeta(Sources).
Upgrading from a release candidate
Section titled “Upgrading from a release candidate”- Install with a version floor,
uvx --from "obsei>=1.0" obsei ...; a plainuvx obseican reuse a cached release candidate. obsei[mcp]is no longer needed; the extra still exists, empty.- Webhook receivers: events are CloudEvents with records under
data.records, signed with thewebhook-id,webhook-timestampandwebhook-signatureheaders. TheX-Obsei-TimestampandX-Obsei-Signature-256headers are gone, for the sink and forobsei serveintake (Serve). - Projects created before rc5 have no
.obsei/secrets.env; keep exportingOBSEI_DB_KEYandOBSEI_PSEUDONYM_SALT, or move them into that file. - The store migrates itself on first open (deliveries, alert state and approvals tables).