Skip to content
Back to search

obsei

MarketplaceWorks with Claude CodeGitHub

Open source, privacy-first Voice of Customer analytics. A self-hosted alternative to Enterpret and Unwrap that strips PII from feedback before any LLM sees it.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/obsei/obsei with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/obsei/obsei'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/obsei--obsei/badge.svg)](/listings/obsei--obsei)

HTML

<a href="/listings/obsei--obsei"><img src="/api/listings/obsei--obsei/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

mkdir voc && cd voc
uvx --from "obsei[recommended]>=1.0" obsei init   # obsei.yaml, secrets, sample data, local model
obsei try                              # table of redacted, labelled feedback; nothing stored
obsei try https://apps.apple.com/us/app/whatsapp-messenger/id310633997   # or GitHub, HN, a feed, a CSV
obsei add appstore                     # add sources and sinks without editing YAML (obsei integrations)
obsei add slack                        # asks for the webhook, keeps it in .obsei/secrets.env
obsei check                            # every source and sink: secrets, egress, credentials
obsei run                              # fetch, redact, label, deliver, store
obsei serve                            # scheduled pipelines, webhooks, MCP and Studio
obsei doctor                           # environment, secrets, encryption, egress mode, plugins

`obsei[recommended]` is the full local setup (the classifier and multilingual themes); `obsei` alone is enough for redaction, sources and sinks. To keep the `obsei` command, install it once: `uv tool install "obsei[recommended]"` (or `pip install`). `obsei init` writes a random database key and pseudonym salt to `.obsei/secrets.env` (owner-only, git-ignored), and every command loads it; on servers and in CI, set `OBSEI_DB_KEY` and `OBSEI_PSEUDONYM_SALT` instead, or mount the file. With `obsei[local]`, the `classify` enricher labels sentiment, intent and language on the CPU with no model server. A [decision model](https://docs.obsei.com/guides/models/#decision-models) on llama.cpp or any OpenAI-compatible endpoint also works: Ollama, vLLM, Azure OpenAI, OpenAI, Mistral, or a LiteLLM proxy for Bedrock and Vertex ([benchmark](https://docs.obsei.com/guides/models/#benchmark)). Public endpoints are refused until you choose `OBSEI_EGRESS_MODE=private` (with `OBSEI_EGRESS_ALLOW`) or `hybrid`.

<picture> <source media="(prefers-color-scheme: dark)" srcset="docs/public/brand/integrations-dark.svg"> </picture>

| | Built in | | --- | --- | | Sources | CSV, JSON Lines, declarative REST, webhooks, App Store (any country), App Store Connect, Google Play (official API), GitHub issues, Hacker News, Bluesky, YouTube, RSS/Atom, SQL databases and warehouses, file drops, IMAP mailboxes, any MCP server, Zendesk, Freshdesk, Intercom, Gong; Reddit as an unpublished community plugin (install from Git) | | Enrichers | Classification with an in-process zero-shot model (default), a decision model (Julia-1, Clef) or an LLM: sentiment, intent, language and custom choice, score and yes/no fields with confidence; low-confidence answers go to a stronger model or human review; `filter` drops or tags spam and off-topic records | | Sinks | Signed webhooks (Standard Webhooks, CloudEvents) with retries, Slack, Telegram, Discord, email and Teams via Apprise (`obsei[notify]`), GitHub issues, Jira, Linear, Parquet, SQL databases and warehouses; ordered routes on labels, confidence and scores ([routing](https://docs.obsei.com/guides/routing/)) | | Analysis | Stable themes (offline, or multilingual with `obsei[embeddings]`) with near-duplicate detection, k-anonymous themes, `obsei ask` with cited answers and an optional grounding judge, read-only Studio with a knowledge-graph explorer and privacy, decisions, trends and routes panels ([demo](https://docs.obsei.com/demo/)), Slack `/obsei` command, [alerts](https://docs.obsei.com/guides/alerts/) on theme spikes, new themes, digests, the review queue and pipeline health | | Privacy | Redaction of emails, phones, cards and IBANs, plus national IDs for 16 countries in the Americas, Europe, Asia-Pacific and Africa, checksum-validated where the format has one, in any script; optional name redaction (`obsei[names]`); salted author pseudonyms; encrypted DuckDB; `obsei forget`, `obsei export` and `obsei audit` | | Server | `obsei serve`: scheduled pipelines, signed webhook intake, MCP over HTTP, Studio, role-based access and SSO-proxy support |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "obsei",
  3. "owner": { "name": "obsei", "url": "https://obsei.com" },
  4. "metadata": {
  5. "description": "obsei plugins: privacy-first, self-hosted Voice of Customer for AI agents."
  6. },
  7. "plugins": [
  8. {
  9. "name": "obsei",
  10. "source": "./integrations/claude/obsei",
  11. "description": "Privacy-first Voice of Customer: query self-hosted customer feedback with cited evidence."
  12. }
  13. ]
  14. }
README.md · README · 140 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="docs/public/logo.png" alt="obsei" width="120">
  3. </p>
  4. <h1 align="center">obsei</h1>
  5. <p align="center"><b>Know what customers are saying. Keep what they said private.</b><br>
  6. The self-hosted, open source alternative to Enterpret and Unwrap that strips PII before any LLM sees it.<br>Bring your own sources, models and agents.</p>
  7. <p align="center">
  8. <a href="https://docs.obsei.com/">Docs</a> ·
  9. <a href="https://docs.obsei.com/demo/">Live demo</a> ·
  10. <a href="https://obsei.com/">Website</a> ·
  11. <a href="https://blog.obsei.com/">Blog</a> ·
  12. <a href="https://github.com/obsei/obsei/discussions">Discussions</a>
  13. </p>
  14. <p align="center">
  15. <a href="https://github.com/obsei/obsei/actions/workflows/ci.yml"><img src="https://github.com/obsei/obsei/actions/workflows/ci.yml/badge.svg?branch=master&event=push" alt="CI"></a>
  16. <a href="https://pypi.org/project/obsei/"><img src="https://img.shields.io/pypi/v/obsei?color=238a91" alt="PyPI"></a>
  17. <a href="https://github.com/obsei/obsei/pkgs/container/obsei"><img src="https://img.shields.io/badge/container-ghcr.io-1a6d9d" alt="Container"></a>
  18. <a href="https://scorecard.dev/viewer/?uri=github.com/obsei/obsei"><img src="https://api.scorecard.dev/projects/github.com/obsei/obsei/badge" alt="OpenSSF Scorecard"></a>
  19. <a href="https://github.com/obsei/obsei/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-238a91" alt="License"></a>
  20. </p>
  21. ---
  22. Teams want to understand what customers say in reviews, tickets, calls and surveys, but often can't
  23. send that text to another SaaS or a public LLM. obsei runs entirely inside your own infrastructure:
  24. - **Private by design.** PII is redacted (and optionally names) and authors are pseudonymised at
  25. ingest. Encrypted database, model and sink traffic air-gapped by default, no telemetry, erasure and an audit log built in.
  26. - **Bring your own.** Your sources, your keys and your model: a zero-shot classifier that runs
  27. in process by default, a decision model such as Julia-1, or Ollama, vLLM, Azure OpenAI, OpenAI,
  28. Bedrock and Vertex through LiteLLM.
  29. - **AI-native.** An MCP server and a Claude plugin, so agents answer questions about
  30. customers with cited, privacy-filtered evidence and propose issues that you approve.
  31. - **Many languages.** Feedback is classified and quoted in its own language. With
  32. `obsei[embeddings]`, a local multilingual model groups the same issue across 50+ languages;
  33. without it, the offline embedder groups by wording, so each language forms its own themes.
  34. obsei provides controls that *support* compliance with laws such as the GDPR, India's DPDP Act,
  35. Brazil's LGPD and California's CCPA. It makes no compliance claims; you remain the data controller.
  36. > [!NOTE]
  37. > 1.0 is a new codebase, not compatible with 0.0.x. The legacy 0.0.x toolkit lives on the `legacy/0.0.x`
  38. > branch (`pip install "obsei<1"`); see [Migrate from 0.0.x](https://docs.obsei.com/guides/migrate-from-0-0/).
  39. ## Quickstart
  40. ```bash
  41. mkdir voc && cd voc
  42. uvx --from "obsei[recommended]>=1.0" obsei init # obsei.yaml, secrets, sample data, local model
  43. obsei try # table of redacted, labelled feedback; nothing stored
  44. obsei try https://apps.apple.com/us/app/whatsapp-messenger/id310633997 # or GitHub, HN, a feed, a CSV
  45. obsei add appstore # add sources and sinks without editing YAML (obsei integrations)
  46. obsei add slack # asks for the webhook, keeps it in .obsei/secrets.env
  47. obsei check # every source and sink: secrets, egress, credentials
  48. obsei run # fetch, redact, label, deliver, store
  49. obsei serve # scheduled pipelines, webhooks, MCP and Studio
  50. obsei doctor # environment, secrets, encryption, egress mode, plugins
  51. ```
  52. obsei needs Python 3.11 or newer; on older Pythons, pip quietly installs the legacy 0.0.x instead,
  53. so keep the `>=1.0` floor. `obsei[recommended]` is the full local setup (the classifier and
  54. multilingual themes); `obsei` alone is enough for redaction, sources and sinks. To keep the `obsei`
  55. command, install it once: `uv tool install "obsei[recommended]>=1.0"` (or `pip install`). `obsei init` writes a random database key and pseudonym salt to
  56. `.obsei/secrets.env` (owner-only, git-ignored), and every command loads it; on servers and in CI,
  57. set `OBSEI_DB_KEY` and `OBSEI_PSEUDONYM_SALT` instead, or mount the file. With `obsei[local]`, the
  58. `classify` enricher labels sentiment, intent and language on the CPU with no model server. A
  59. [decision model](https://docs.obsei.com/guides/models/#decision-models) on
  60. llama.cpp or any OpenAI-compatible endpoint also works: Ollama, vLLM, Azure OpenAI, OpenAI, Mistral,
  61. or a LiteLLM proxy for Bedrock and Vertex ([benchmark](https://docs.obsei.com/guides/models/#benchmark)).
  62. Public endpoints are refused until you choose `OBSEI_EGRESS_MODE=private` (with `OBSEI_EGRESS_ALLOW`)
  63. or `hybrid`.
  64. <picture>
  65. <source media="(prefers-color-scheme: dark)" srcset="docs/public/brand/integrations-dark.svg">
  66. <img alt="Sources: App Store, Google Play, Zendesk, Freshdesk, Intercom, Gong, GitHub issues, Hacker News, Bluesky, YouTube, Reddit, Typeform, RSS, email, SQL, CSV, any REST API, any MCP tool. Destinations: Slack, Teams, Jira, Linear, GitHub issues, Apprise, signed webhooks, SQL, Parquet." src="docs/public/brand/integrations-light.svg" width="920">
  67. </picture>
  68. | | Built in |
  69. | --- | --- |
  70. | Sources | CSV, JSON Lines, declarative REST, webhooks, App Store (any country), App Store Connect, Google Play (official API), GitHub issues, Hacker News, Bluesky, YouTube, RSS/Atom, SQL databases and warehouses, file drops, IMAP mailboxes, any MCP server, Zendesk, Freshdesk, Intercom, Gong; Reddit as an unpublished community plugin (install from Git) |
  71. | Enrichers | Classification with an in-process zero-shot model (default), a decision model (Julia-1, Clef) or an LLM: sentiment, intent, language and custom choice, score and yes/no fields with confidence; low-confidence answers go to a stronger model or human review; `filter` drops or tags spam and off-topic records |
  72. | Sinks | Signed webhooks (Standard Webhooks, CloudEvents) with retries, Slack, Telegram, Discord, email and Teams via Apprise (`obsei[notify]`), GitHub issues, Jira, Linear, Parquet, SQL databases and warehouses; ordered routes on labels, confidence and scores ([routing](https://docs.obsei.com/guides/routing/)) |
  73. | Analysis | Stable themes (offline, or multilingual with `obsei[embeddings]`) with near-duplicate detection, k-anonymous themes, `obsei ask` with cited answers and an optional grounding judge, read-only Studio with a knowledge-graph explorer and privacy, decisions, trends and routes panels ([demo](https://docs.obsei.com/demo/)), Slack `/obsei` command, [alerts](https://docs.obsei.com/guides/alerts/) on theme spikes, new themes, digests, the review queue and pipeline health |
  74. | Privacy | Redaction of emails, phones, cards and IBANs, plus national IDs for 16 countries in the Americas, Europe, Asia-Pacific and Africa, checksum-validated where the format has one, in any script; optional name redaction (`obsei[names]`); salted author pseudonyms; encrypted DuckDB; `obsei forget`, `obsei export` and `obsei audit` |
  75. | Server | `obsei serve`: scheduled pipelines, signed webhook intake, MCP over HTTP, Studio, role-based access and SSO-proxy support |
  76. Agents: `obsei mcp` serves MCP tools (read-only, plus proposals you approve); the Claude Code plugin is
  77. `/plugin marketplace add obsei/obsei`. See the [docs](https://docs.obsei.com/) and
  78. [integrations](integrations/README.md).
  79. Examples: ready-to-run configs for app reviews in many countries, helpdesks, support-ticket triage
  80. with a decision model and routes, social listening,
  81. REST APIs (Trustpilot, HubSpot, ServiceNow, Mastodon), warehouses, mailboxes and air-gapped
  82. enterprise setups are in the [examples gallery](https://docs.obsei.com/examples/).
  83. Docker (run in the project directory; images are tagged by release):
  84. <!-- x-release-please-start-version -->
  85. ```bash
  86. docker run --rm -v "$PWD:/data" -w /data --user "$(id -u):$(id -g)" \
  87. ghcr.io/obsei/obsei:1.1.1 run # reads .obsei/secrets.env, or pass -e OBSEI_DB_KEY ...
  88. ```
  89. <!-- x-release-please-end -->
  90. ## Use it from your AI tool
  91. The MCP server and `voice-of-customer` skill install straight from this repository (obsei isn't
  92. in any tool's official plugin directory yet):
  93. | Tool | Install |
  94. | --- | --- |
  95. | Claude Code | `/plugin install obsei --marketplace obsei/obsei` |
  96. | Codex | `codex plugin marketplace add obsei/obsei`, then `codex plugin add obsei@obsei` |
  97. | GitHub Copilot CLI | `copilot plugin install obsei/obsei:integrations/claude/obsei` |
  98. | Gemini CLI | `gemini extensions install https://github.com/obsei/obsei` |
  99. | Any MCP client | `uvx --from "obsei>=1.0" obsei mcp` |
  100. [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=obsei&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJvYnNlaT49MS4wIiwib2JzZWkiLCJtY3AiXX0%3D)
  101. [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_obsei-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=obsei&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22obsei%3E%3D1.0%22%2C%22obsei%22%2C%22mcp%22%5D%7D)
  102. VS Code, Devin Desktop, Zed, JetBrains, Kiro, Goose, Cline and ChatGPT: see
  103. [AI tools](https://docs.obsei.com/guides/ai-tools/).
  104. ## Roadmap
  105. Phases 0.1 to 0.5 (private core, MCP and Claude plugin, enterprise bring-your-own, themes and
  106. Studio, decision models and routing) shipped in 1.0. See [ROADMAP.md](ROADMAP.md) for what is next.
  107. ## Contributing
  108. Questions and ideas go to [Discussions](https://github.com/obsei/obsei/discussions). See
  109. [CONTRIBUTING.md](CONTRIBUTING.md) for setup, conventions and the DCO sign-off.
  110. ## License
  111. [Apache-2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.