open-notebook/docs/0-START-HERE/quick-start-openai.md

Quick Start - OpenAI (5 minutes)

Get Open Notebook running with OpenAI's GPT models. Fast, powerful, and simple.

Prerequisites

1. Docker Desktop installed

   • Download here
   • Already have it? Skip to step 2

2. OpenAI API Key (required)

   • Go to https://platform.openai.com/api-keys
   • Create account → Create new secret key
   • Add at least $5 in credits to your account
   • Copy the key (starts with sk-)

Step 1: Create Configuration (1 min)

Create a new folder open-notebook and add this file:

docker-compose.yml:

services:
  surrealdb:
    image: surrealdb/surrealdb:v2
    command: start --user root --pass password --bind 0.0.0.0:8000 memory
    ports:
      - "8000:8000"

  api:
    image: lfnovo/open_notebook:v1-latest
    ports:
      - "5055:5055"
    environment:
      # Your OpenAI key
      - OPENAI_API_KEY=sk-...

      # Database (required)
      - SURREAL_URL=ws://surrealdb:8000/rpc
      - SURREAL_USER=root
      - SURREAL_PASSWORD=password
      - SURREAL_NAMESPACE=open_notebook
      - SURREAL_DATABASE=production
    depends_on:
      - surrealdb
    volumes:
      - ./data:/app/data
    restart: always

  frontend:
    image: lfnovo/open_notebook-frontend:v1-latest
    ports:
      - "3000:3000"
    environment:
      - NEXT_PUBLIC_API_URL=http://localhost:5055
    depends_on:
      - api
    restart: always

Edit the file:

• Replace sk-... with your actual OpenAI API key

---

Step 2: Start Services (1 min)

Open terminal in your open-notebook folder:

docker compose up -d

Wait 15-20 seconds for services to start.

---

Step 3: Access Open Notebook (instant)

Open your browser:

http://localhost:3000

You should see the Open Notebook interface!

---

Step 4: Create Your First Notebook (1 min)

1. Click New Notebook
2. Name: "My Research"
3. Click Create

---

Step 5: Add a Source (1 min)

1. Click Add Source
2. Choose Web Link
3. Paste: https://en.wikipedia.org/wiki/Artificial_intelligence
4. Click Add
5. Wait for processing (30-60 seconds)

---

Step 6: Chat With Your Content (1 min)

1. Go to Chat
2. Type: "What is artificial intelligence?"
3. Click Send
4. Watch as GPT responds with information from your source!

---

Verification Checklist

• Docker is running
• You can access http://localhost:3000
• You created a notebook
• You added a source
• Chat works

All checked? 🎉 You have a fully working AI research assistant!

---

Using Different Models

In your notebook, go to Settings → Models to choose:

• gpt-4o - Best quality (recommended)
• gpt-4o-mini - Fast and cheap (good for testing)

---

Troubleshooting

"Port 3000 already in use"

Change the port in docker-compose.yml:

ports:
  - "3001:3000"  # Use 3001 instead

Then access at http://localhost:3001

"API key not working"

1. Double-check your API key (no extra spaces)
2. Verify you added credits at https://platform.openai.com
3. Restart: docker compose restart api

"Cannot connect to server"

docker ps  # Check all services running
docker compose logs  # View logs
docker compose restart  # Restart everything

---

Next Steps

1. Add Your Own Content: PDFs, web links, documents
2. Explore Features: Podcasts, transformations, search
3. Full Documentation: See all features

---

Cost Estimate

OpenAI pricing (approximate):

• Conversation: $0.01-0.10 per 1K tokens
• Embeddings: $0.02 per 1M tokens
• Typical usage: $1-5/month for light use, $20-50/month for heavy use

Check https://openai.com/pricing for current rates.

---

Need help? Join our Discord community!