open-notebook/docs/getting-started/quick-start.md

Quick Start Guide - Get Open Notebook Running in 5 Minutes

Get up and running with Open Notebook in just a few minutes! This guide will get you from zero to your first AI-powered notebook quickly.

Prerequisites

Before starting, ensure you have:

1. Docker Desktop installed and running

   • Download for Windows/Mac
   • Linux: sudo apt install docker.io docker-compose

2. OpenAI API Key (recommended for beginners)

   • Go to OpenAI Platform
   • Create account → API Keys → Create new secret key
   • Add $5+ credits to your account for API usage

Single Command Setup

Step 1: Create Your Setup Files

Create a new folder called open-notebook and add these two files:

docker-compose.yml:

services:
  open_notebook:
    image: lfnovo/open_notebook:v1-latest-single
    ports:
      - "8502:8502"
    env_file:
      - ./docker.env
    pull_policy: always
    volumes:
      - ./notebook_data:/app/data
      - ./surreal_single_data:/mydata
    restart: always

docker.env:

# Replace YOUR_OPENAI_API_KEY_HERE with your actual API key
OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE

# Database settings (don't change these)
SURREAL_URL="ws://localhost:8000/rpc"
SURREAL_USER="root"
SURREAL_PASSWORD="root"
SURREAL_NAMESPACE="open_notebook"
SURREAL_DATABASE="production"

Step 2: Start Open Notebook

Open terminal/command prompt in your open-notebook folder and run:

docker-compose up -d

That's it! Open Notebook is now running at: http://localhost:8502

Basic Verification

1. Check Services: Visit http://localhost:8502 - you should see the Open Notebook interface
2. API Health: Visit http://localhost:5055/docs - you should see the API documentation
3. No Errors: Run docker-compose logs to ensure no error messages

Simple Example Workflow

1. Configure AI Models

• Click Models in the sidebar
• Set these recommended models:
  • Language Model: gpt-5-mini
  • Embedding Model: text-embedding-3-small
  • Text-to-Speech: gpt-4o-mini-tts
  • Speech-to-Text: whisper-1
• Click Save

2. Create Your First Notebook

• Click "Create New Notebook"
• Name: "My Research"
• Description: "Getting started with Open Notebook"
• Click "Create"

3. Add a Source

• Click "Add Source"
• Choose "Link" and paste: https://en.wikipedia.org/wiki/Artificial_intelligence
• Click "Add Source"
• Wait for processing to complete

4. Generate Your First Note

• Go to the Notes column
• Click "Create AI Note"
• Enter prompt: "Summarize the key concepts of artificial intelligence"
• Click "Generate Note"
• Watch as AI creates a comprehensive summary!

5. Chat with Your Content

• Go to the Chat column
• Ask: "What are the main applications of AI mentioned in the source?"
• Get instant answers with citations from your content

Next Steps

Now that you have Open Notebook running:

Essential Features to Explore

• 📁 Content Support - Learn what file types you can add
• 🔍 Search - Master full-text and vector search
• 🎙️ Podcast Generation - Create multi-speaker podcasts from your research
• ⚙️ Transformations - Extract insights and summaries

Advanced Setup

• 🔧 Development Setup - Run from source code
• ☁️ Deployment - Deploy to cloud services
• 🤖 AI Models - Add more AI providers beyond OpenAI

Getting Help

• 💬 Discord Community - Get help and share ideas
• 📖 Full Documentation - Complete feature guide
• 🐛 Report Issues - Found a bug?

Common Issues

Port Already in Use

docker-compose down
docker-compose up -d

API Key Errors

• Double-check your API key in docker.env
• Ensure you have credits in your OpenAI account
• Verify no extra spaces around the key

Container Won't Start

docker-compose down -v
docker-compose up -d

Can't Access Interface

• Ensure Docker Desktop is running
• Check firewall isn't blocking port 8502
• Try: docker-compose restart

Stopping Open Notebook

To stop:

docker-compose down

To start again:

docker-compose up -d

---

Congratulations! You now have Open Notebook running and ready for your research workflow. Start by adding your own documents and see how AI can enhance your note-taking and research process.

Next recommended read: Basic Workflow Guide to learn effective research patterns.