open-notebook

A private, multi-model, 100% local, full-featured alternative to Notebook LM

In a world dominated by Artificial Intelligence, having the ability to think 🧠 and acquire new knowledge 💡, is a skill that should not be a privilege for a few, nor restricted to a single provider.

undefinedOpen Notebook empowers you to:undefined

• 🔒 Control your data - Keep your research private and secure
• 🤖 Choose your AI models - Support for 18+ providers including OpenAI, Anthropic, Ollama, LM Studio, and more
• 📚 Organize multi-modal content - PDFs, videos, audio, web pages, and more
• 🎙️ Generate professional podcasts - Advanced multi-speaker podcast generation
• 🔍 Search intelligently - Full-text and vector search across all your content
• 💬 Chat with context - AI conversations powered by your research
• 🌐 Multi-language UI - English, Portuguese, Chinese (Simplified & Traditional), Japanese, Russian, and Bengali support

Learn more about our project at https://www.open-notebook.ai

---

🆚 Open Notebook vs Google Notebook LM

Feature	Open Notebook	Google Notebook LM	Advantage
undefinedPrivacy & Controlundefined	Self-hosted, your data	Google cloud only	Complete data sovereignty
undefinedAI Provider Choiceundefined	18+ providers (OpenAI, Anthropic, Ollama, LM Studio, etc.)	Google models only	Flexibility and cost optimization
undefinedPodcast Speakersundefined	1-4 speakers with custom profiles	2 speakers only	Extreme flexibility
undefinedContent Transformationsundefined	Custom and built-in	Limited options	Unlimited processing power
undefinedAPI Accessundefined	Full REST API	No API	Complete automation
undefinedDeploymentundefined	Docker, cloud, or local	Google hosted only	Deploy anywhere
undefinedCitationsundefined	Basic references (will improve)	Comprehensive with sources	Research integrity
undefinedCustomizationundefined	Open source, fully customizable	Closed system	Unlimited extensibility
undefinedCostundefined	Pay only for AI usage	Free tier + Monthly subscription	Transparent and controllable

undefinedWhy Choose Open Notebook?undefined

• 🔒 Privacy First: Your sensitive research stays completely private
• 💰 Cost Control: Choose cheaper AI providers or run locally with Ollama
• 🎙️ Better Podcasts: Full script control and multi-speaker flexibility vs limited 2-speaker deep-dive format
• 🔧 Unlimited Customization: Modify, extend, and integrate as needed
• 🌐 No Vendor Lock-in: Switch providers, deploy anywhere, own your data

Built With

🚀 Quick Start (2 Minutes)

Prerequisites

• Docker Desktop installed
• That’s it! (API keys configured later in the UI)

Step 1: Get docker-compose.yml

undefinedOption A: Download directly

curl -o docker-compose.yml https://raw.githubusercontent.com/lfnovo/open-notebook/main/docker-compose.yml

undefinedOption B: Create the file manually
Copy this into a new file called docker-compose.yml:

services:
  surrealdb:
    image: surrealdb/surrealdb:v2
    command: start --log info --user root --pass root rocksdb:/mydata/mydatabase.db
    user: root
    ports:
      - "8000:8000"
    volumes:
      - ./surreal_data:/mydata
    restart: always

  open_notebook:
    image: lfnovo/open_notebook:v1-latest
    ports:
      - "8502:8502"
      - "5055:5055"
    environment:
      - OPEN_NOTEBOOK_ENCRYPTION_KEY=change-me-to-a-secret-string
      - SURREAL_URL=ws://surrealdb:8000/rpc
      - SURREAL_USER=root
      - SURREAL_PASSWORD=root
      - SURREAL_NAMESPACE=open_notebook
      - SURREAL_DATABASE=open_notebook
    volumes:
      - ./notebook_data:/app/data
    depends_on:
      - surrealdb
    restart: always

Step 2: Set Your Encryption Key

Edit docker-compose.yml and change this line:

- OPEN_NOTEBOOK_ENCRYPTION_KEY=change-me-to-a-secret-string

to any secret value (e.g., my-super-secret-key-123)

Step 3: Start Services

docker compose up -d

Wait 15-20 seconds, then open: http://localhost:8502undefined

Step 4: Configure AI Provider

1. Go to Settings → API Keysundefined
2. Click Add Credentialundefined
3. Choose your provider (OpenAI, Anthropic, Google, etc.)
4. Paste your API key and click Saveundefined
5. Click Test Connection → Discover Models → Register Modelsundefined

Done! You’re ready to create your first notebook.

undefinedNeed an API key? Get one from:
OpenAI · Anthropic · Google · Groq (free tier)

undefinedWant free local AI? See examples/docker-compose-ollama.yml for Ollama setup

---

📚 More Installation Options

• undefinedWith Ollama (Free Local AI) - Run models locally without API costs
• undefinedFrom Source (Developers) - For development and contributions
• undefinedComplete Installation Guide - All deployment scenarios

---

📖 Need Help?

• undefined🤖 AI Installation Assistant: CustomGPT to help you install
• undefined🆘 Troubleshooting: 5-minute troubleshooting guide
• undefined💬 Community Support: Discord Server
• undefined🐛 Report Issues: GitHub Issues

---

Star History

Provider Support Matrix

Thanks to the Esperanto library, we support this providers out of the box!

Provider	LLM Support	Embedding Support	Speech-to-Text	Text-to-Speech
OpenAI	✅	✅	✅	✅
Anthropic	✅	❌	❌	❌
Groq	✅	❌	✅	❌
Google (GenAI)	✅	✅	❌	✅
Vertex AI	✅	✅	❌	✅
Ollama	✅	✅	❌	❌
Perplexity	✅	❌	❌	❌
ElevenLabs	❌	❌	✅	✅
Azure OpenAI	✅	✅	❌	❌
Mistral	✅	✅	❌	❌
DeepSeek	✅	❌	❌	❌
Voyage	❌	✅	❌	❌
xAI	✅	❌	❌	❌
OpenRouter	✅	❌	❌	❌
DashScope (Qwen)	✅	❌	❌	❌
MiniMax	✅	❌	❌	❌
OpenAI Compatible*	✅	❌	❌	❌

*Supports LM Studio and any OpenAI-compatible endpoint

✨ Key Features

Core Capabilities

• undefined🔒 Privacy-First: Your data stays under your control - no cloud dependencies
• undefined🎯 Multi-Notebook Organization: Manage multiple research projects seamlessly
• undefined📚 Universal Content Support: PDFs, videos, audio, web pages, Office docs, and more
• undefined🤖 Multi-Model AI Support: 18+ providers including OpenAI, Anthropic, Ollama, Google, LM Studio, and more
• undefined🎙️ Professional Podcast Generation: Advanced multi-speaker podcasts with Episode Profiles
• undefined🔍 Intelligent Search: Full-text and vector search across all your content
• undefined💬 Context-Aware Chat: AI conversations powered by your research materials
• undefined📝 AI-Assisted Notes: Generate insights or write notes manually

Advanced Features

• undefined⚡ Reasoning Model Support: Full support for thinking models like DeepSeek-R1 and Qwen3
• undefined🔧 Content Transformations: Powerful customizable actions to summarize and extract insights
• undefined🌐 Comprehensive REST API: Full programmatic access for custom integrations
• undefined🔐 Optional Password Protection: Secure public deployments with authentication
• undefined📊 Fine-Grained Context Control: Choose exactly what to share with AI models
• undefined📎 Citations: Get answers with proper source citations

Podcast Feature

📚 Documentation

Getting Started

• undefined📖 Introduction - Learn what Open Notebook offers
• undefined⚡ Quick Start - Get up and running in 5 minutes
• undefined🔧 Installation - Comprehensive setup guide
• undefined🎯 Your First Notebook - Step-by-step tutorial

User Guide

• undefined📱 Interface Overview - Understanding the layout
• undefined📚 Notebooks - Organizing your research
• undefined📄 Sources - Managing content types
• undefined📝 Notes - Creating and managing notes
• undefined💬 Chat - AI conversations
• undefined🔍 Search - Finding information

Advanced Topics

• undefined🎙️ Podcast Generation - Create professional podcasts
• undefined🔧 Content Transformations - Customize content processing
• undefined🤖 AI Models - AI model configuration
• undefined🔌 MCP Integration - Connect with Claude Desktop, VS Code and other MCP clients
• undefined🔧 REST API Reference - Complete API documentation
• undefined🔐 Security - Password protection and privacy
• undefined🚀 Deployment - Complete deployment guides for all scenarios

(back to top)

🗺️ Roadmap

Upcoming Features

• undefinedLive Front-End Updates: Real-time UI updates for smoother experience
• undefinedAsync Processing: Faster UI through asynchronous content processing
• undefinedCross-Notebook Sources: Reuse research materials across projects
• undefinedBookmark Integration: Connect with your favorite bookmarking apps

Recently Completed ✅

• undefinedNext.js Frontend: Modern React-based frontend with improved performance
• undefinedComprehensive REST API: Full programmatic access to all functionality
• undefinedMulti-Model Support: 18+ AI providers including OpenAI, Anthropic, Ollama, LM Studio
• undefinedAdvanced Podcast Generator: Professional multi-speaker podcasts with Episode Profiles
• undefinedContent Transformations: Powerful customizable actions for content processing
• undefinedEnhanced Citations: Improved layout and finer control for source citations
• undefinedMultiple Chat Sessions: Manage different conversations within notebooks

See the open issues for a full list of proposed features and known issues.

(back to top)

📖 Need Help?

• undefined🤖 AI Installation Assistant: We have a CustomGPT built to help you install Open Notebook - it will guide you through each step!
• undefinedNew to Open Notebook? Start with our Getting Started Guide
• undefinedNeed installation help? Check our Installation Guide
• undefinedWant to see it in action? Try our Quick Start Tutorial

🤝 Community & Contributing

Join the Community

• 💬 Discord Server - Get help, share ideas, and connect with other users
• 🐛 GitHub Issues - Report bugs and request features
• ⭐ Star this repo - Show your support and help others discover Open Notebook

Contributing

We welcome contributions! We’re especially looking for help with:

• undefinedFrontend Development: Help improve our modern Next.js/React UI
• undefinedTesting & Bug Fixes: Make Open Notebook more robust
• undefinedFeature Development: Build the coolest research tool together
• undefinedDocumentation: Improve guides and tutorials

undefinedCurrent Tech Stack: Python, FastAPI, Next.js, React, SurrealDB
undefinedFuture Roadmap: Real-time updates, enhanced async processing

See our Contributing Guide for detailed information on how to get started.

(back to top)

📄 License

Open Notebook is MIT licensed. See the LICENSE file for details.

undefinedCommunity Support:

• 💬 Discord Server - Get help, share ideas, and connect with users
• 🐛 GitHub Issues - Report bugs and request features
• 🌐 Website - Learn more about the project

(back to top)