Get Started

There is a couple of ways you can start using Open Notebook depending on your objectives and technical knowledge.

🐳 Docker Setup (quick start)

This docker-compose approach will get the service running for you.

Just create a file named docker-compose.yaml in a folder on your computer.

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

  open_notebook:
    image: lfnovo/open_notebook:latest
    ports:
      - "8080:8502"
    environment:
        - OPENAI_API_KEY=API_KEY
        - SURREAL_ADDRESS=surrealdb
        - SURREAL_PORT=8000
        - SURREAL_USER=root
        - SURREAL_PASS=root
        - SURREAL_NAMESPACE=open_notebook
        - SURREAL_DATABASE=open_notebook
    depends_on:
      - surrealdb
    pull_policy: always
    volumes:
      - notebook_data:/app/data

volumes:
  surreal_data:
  notebook_data:

You might want to use your local folder for storage instead of a Docker volume. This way it's easier to backup and to check the created files.

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

  open_notebook:
    image: lfnovo/open_notebook:latest
    ports:
      - "8080:8502"
    env_file:
      - docker.env
    depends_on:
      - surrealdb
    pull_policy: always
    volumes:
      - ./notebook_data:/app/data

Then, you can just start the Application

docker compose up -d

Navigate to: http://localhost:8080 and start having fun.

📦 Installing from Source

If you really want to play with the source code.

git clone https://github.com/lfnovo/open_notebook.git
cd open_notebook
poetry install
cp .env.example .env

Run the database with:

docker compose --profile db_only up

Run the app with:

poetry run streamlit run app_home.py

Initial setup after loading the app

After the app is running, you'll be requested to configure your models. Head to the Models page for more informations on this.

Upgrading Open Notebook

Running from source

Just run git pull on the root project folder and then poetry install to update dependencies.

Running from docker

Just pull the latest image with docker pull lfnovo/open_notebook:latest and restart your containers with docker-compose up -d

System Requirements

• Docker Engine running on your machine
• 4GB RAM minimum
• 2GB free disk space (the more the better)
• An API Key for OpenAI, Anthropic, Gemini, Vertex or OpenRouter

Next Steps

1. Create your first notebook
2. Import some content
3. Try out the AI features
4. Write your notes
5. Generate a podcast