README.md

---
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](/docs)
- **REST API**: All endpoints at `/api/v1/...`

## MCP Integration

Connect your local AI assistants to this Space:

```json
{
  "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](https://github.com/lfnovo/open-notebook)
- [Documentation](https://www.open-notebook.ai)
- [Discord Community](https://discord.gg/37XJPXfz2w)

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