VISION.md
This document is the product's source of truth in two layers with different lifespans: Identity (durable — what Open Notebook is and refuses to be) and Current Posture (temporal — where we are in the journey and what's on the horizon). Triage and design decisions are evaluated against this document; the reasoning behind each rule lives in the decision records.
Open Notebook is a privacy-focused, self-hosted alternative to Google's Notebook LM that empowers users to:
Durable, normative rules. Each links to the decision record that established it.
| Principle | Rule |
|---|---|
| Privacy first | User data stays under user control by default. Self-hosted is the primary use case; no telemetry without opt-in; no hard dependency on specific cloud services. |
| Provider-agnostic core | The default is portable: features must work across the provider matrix. Adopting a provider-exclusive capability is allowed but is a deliberate decision that requires a PDR (PDR-002). |
| Simplicity over features | Easy to understand and use, even if it means fewer features. Sensible defaults; advanced options behind progressive disclosure. |
| API-first | Every capability is accessible via the REST API — the UI is a client, never the only door (ADR-003). |
| Extensibility through standards | Extension happens through well-defined interfaces (transformations, commands, prompt templates), not forks. |
| Async-first | Long-running operations never block the UI or the API (ADR-004). |
A feature request that conflicts with the IS NOT list or a principle gets closed with a pointer here — kindly, and with the reasoning. A "no" protects the core value proposition; it's not a judgment of the idea. If a request keeps coming back and the principle starts to feel wrong, that's a signal to revisit the principle through a decision record — not to make a quiet exception.
Reviewed: 2026-07. This section is expected to change. Updating it is not a reversal — it's a phase change, recorded with a short PDR and an edit here.
The phase we're in: get the basics working well for everyone before expanding. Priority goes to making the core experience (sources, chat, search, notes, podcasts) solid across the full provider matrix and deployment surface, ahead of new product surfaces.
Decisions about the future we haven't made yet — recorded as "which door to keep open":
The big clusters under consideration — direction, not roadmap; no dates. Each has an umbrella issue where the thinking happens:
| Cluster | What it is | Where |
|---|---|---|
| Platform v-next | SurrealDB v3 migration, possible frontend/backend Docker image split, possible Surreal Commands → Celery move — evaluated together as one coordinated breaking change | #372 · #378 · #381 |
| Multi-user | Deep platform redesign: auth, data scoping, what "multi-user" means for a self-hosted tool | #712 |
| Content modes & artifacts | The output side: generated artifacts, videos, explainers, presentations, mind maps — as one coherent product surface, not a pile of features | #203 |
| Agents operating Open Notebook | Role inversion via MCP: AI agents use Open Notebook on the user's behalf — the platform becomes the research memory of agents, not just a UI | #878 · #693 · #973 |