Premium features overview

Most of mnueron is free and works offline. A few features cost real money to operate (LLM API calls, attachment storage, vision-model runs) and are gated by tier. This page explains the tier matrix and the bring-your-own-key (BYOK) fallback for users who want premium features without the premium subscription.

Tier matrix

Feature	Free local	Free hosted	Paid hosted	BYOK on either
Save / search / recall	✓	✓	✓	n/a
Multi-machine sync	—	✓	✓	n/a
Fact extraction (v0.2.9)	with own API key	per-call opt-in	auto on every long save	✓
Auto-synopsis (v0.4)	with own API key	per-call opt-in	auto on every long save	✓
Attachment text extraction (v0.5)	with own keys	not available	auto	✓ where extractor needs LLM
Image vision description (v0.5)	with own keys	not available	auto with thresholds	✓
Webhook delivery	✓	✓	✓	n/a

Bring-your-own-key (BYOK) flow

The hosted free tier doesn't pay for premium LLM features. If you want them anyway, pass your own Anthropic or OpenAI key per-call via metadata. The key is used for that one operation and then stripped from metadata before the row is persisted — it never lands in the database.

mem.save(
    content=long_text,
    namespace="my-app",
    metadata={
        "summarize": True,
        "byok_anthropic_key": os.environ["MY_ANTHROPIC_KEY"],
    },
)

Same shape for byok_openai_key (used when v0.5 image OCR ships).

Premium features that involve sending content to third-party providers (Anthropic, OpenAI) are off by default on all tiers. You opt in:

Per-call: add the flag to metadata as shown above.
Per-org: site-admin toggles in /admin (paid hosted only).
Per-deploy (self-host): environment variables ENABLE_AUTO_SUMMARY, ENABLE_FACT_EXTRACTION, ENABLE_IMAGE_OCR, ENABLE_ATTACHMENT_EXTRACT.

When any of these features run, the source content is sent to the relevant provider (Anthropic for auto-summary / fact extraction; OpenAI or Anthropic for image vision; tesseract or LLM for attachments). This crosses your data over a network boundary outside Supabase — that's the entire reason for the opt-in gate.

Tier matrix

Bring-your-own-key (BYOK) flow

Privacy and consent (default OFF, opt-in required)