Skip to content

Home

Jump to bottom
Sanni heruwala edited this page Jun 13, 2026 · 4 revisions

RedNotebook AI · Wiki

The open-source AI data notebook for Trino, DuckDB, and 11 more SQL engines. Apache 2.0. Local-first. No telemetry.

🔗 Repository: https://github.com/sanniheruwala/RedNotebookAI 📦 Latest release: v0.7.21 🌐 Try it without installing: huggingface.co/spaces/heruwala/rednotebook-demo — live demo, no signup 💬 Report a bug or propose a feature: see Contributing

What this wiki is

This wiki is the tour. It walks through the project the way a new user or contributor would discover it — concrete examples, screenshots, and how-to flows.

For the canonical reference (architecture, security model, full connector docs, deployment tiers), see /docs in the repo.

Start here

Page What's in it
Quickstart Docker + Python + source. Five minutes to your first query.
Connectors All 13 SQL engines we ship with. Per-dialect field reference.
AI providers OpenAI / Anthropic / Ollama / Mock — and the privacy controls.
File uploads Drop a CSV, query it. The 5-minute analyst win.
Publish and share One-click public HTML share links.
Knowledge layer + Studio NotebookLM-style citations, FAQ, study guide.
Architecture overview How the pieces fit together.
Contributing Issue-first, PR + review, the policy in 60 seconds.
Roadmap Shipped + 🟡 in flight + open design issues.

What's new since the last wiki refresh

v0.7.21 — onboarding conversion + hosted-demo prep

  • 🚀 Quick-connect templates for Supabase, Neon, Vercel Postgres, Railway, Render, Heroku Postgres, DuckDB. The connection dialog leads with these — drop in host + password and you're querying.
  • 🎓 Onboarding tour. A 7-step spotlight walkthrough on first run. Replayable from the ? icon in the topbar.
  • 🏁 "Start here" empty state with three concrete next-step cards instead of a blank canvas.
  • 📦 Bundled sample notebook auto-seeded on first run.
  • 🌐 DEMO_MODE flag + amber banner for public-demo deployments.
  • 📖 Fly.io deployment runbook at docs/deployment/try-rednotebook.md.

v0.7.20 — UX bug-fix patch

  • Dropped duplicate close ✕ from every custom dialog, repaired the History dialog body height so the commit list is actually visible.
  • Removed the misleading Cursor AI provider (no public API exists).
  • Page refresh now preserves cell results (500-row cap per cell).
  • Full History dialog redesign: time-grouped timeline, connected dot rail, sticky restore, actual cell preview on the right.
  • Published HTML now embeds interactive Plotly charts + locale- formatted result tables.

v0.7.19 — virtual files catalog in the metadata tree + HD chart renderer (SVG-crisp at any DPR).

v0.7.18 — Docker hotfix (Alpine→Debian for Next.js SWC arm64) + chown for uploads/published dirs.

v0.7.17 — SQL formatter button per cell (rolled into v0.7.18 image).

v0.7.16 — Publish HTML + drag-drop file uploads.

v0.7.15 — Server-side query cancellation, git-backed autosave history, NotebookLM-style knowledge layer with [n] citations, branch protection on main.

For the full release history see the Releases page.

Open design issues waiting for contributors:

Looking for something specific?

Clone this wiki locally