README.md

metadata

title: Open Notebook
emoji: 📓
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
startup_duration_timeout: 1h
pinned: false
license: mit
suggested_hardware: cpu-upgrade

📓 Open Notebook

An open source, privacy-focused alternative to Google's Notebook LM!

Features

• 🔒 Privacy First - Self-hosted, your data stays under your control
• 🤖 18+ AI Providers - OpenAI, Anthropic, Google, Ollama, and more
• 📚 Multi-modal Content - PDFs, videos, audio, web pages
• 🎙️ Podcast Generation - Advanced multi-speaker podcasts
• 🔍 Intelligent Search - Full-text and vector search
• 💬 Context-Aware Chat - AI conversations powered by your research
• 🌐 REST API - Full programmatic access at /docs
• 🔌 MCP Integration - Connect with Claude Desktop, VS Code, etc.

Quick Start

1. Configure AI Provider: Go to Settings → API Keys → Add your provider
2. Create a Notebook: Start organizing your research
3. Add Sources: Upload PDFs, paste URLs, or add text content
4. Chat & Generate: Ask questions, generate insights, create podcasts

API Access

• Swagger Docs: /docs
• REST API: All endpoints at /api/v1/...

MCP Integration

Connect your local AI assistants to this Space:

{
  "mcpServers": {
    "open-notebook": {
      "command": "uvx",
      "args": ["open-notebook-mcp"],
      "env": {
        "OPEN_NOTEBOOK_URL": "https://YOUR-USERNAME-open-notebook.hf.space"
      }
    }
  }
}

Configuration

Set these in your Space Settings → Secrets:

Secret	Required	Description
OPEN_NOTEBOOK_ENCRYPTION_KEY	✅	Encrypts API keys in database
BASIC_AUTH_USERNAME	Optional	Password-protect the UI
BASIC_AUTH_PASSWORD	Optional	Password-protect the UI

Links

• GitHub Repository
• Documentation
• Discord Community

⚠️ Persistent Storage: Enable Persistent Storage in Space Settings to keep your data between restarts.