Open Notebook

Connect Open Notebook to TensorX and get a privacy-focused, self-hosted NotebookLM alternative with access to all our models.

---

What is Open Notebook?

Open Notebook is an open-source, AI-powered note-taking and research platform. It's a privacy-first alternative to Google's NotebookLM, supporting 16+ AI providers including OpenAI-compatible APIs like TensorX.

Why Open Notebook + TensorX?

• 🔒 Privacy-first - Self-hosted, your data stays under your control
• 🎙️ Podcast generation - Transform notes into multi-speaker audio podcasts
• 📁 Multi-format support - PDFs, videos, audio, web pages, and more
• 💬 Context-aware chat - AI conversations powered by your research
• 🔍 Intelligent search - Full-text and vector search across all content

---

Prerequisites

• Docker installed on your system
• A TensorX API key (sign up here)
• At least 4GB RAM and 10GB disk space

---

Quick Start with Docker

Deploy Open Notebook with TensorX in one command:

docker run -d \
  --name open-notebook \
  --restart unless-stopped \
  -p 8502:8502 \
  -e OPENAI_COMPATIBLE_BASE_URL=https://api.tensorx.ai/v1 \
  -e OPENAI_COMPATIBLE_API_KEY=your-tensorx-api-key \
  -v open-notebook-data:/data \
  ghcr.io/lfnovo/open-notebook:latest

Replace your-tensorx-api-key with your actual TensorX API key!

Then open http://localhost:8502 in your browser.

---

Docker Compose Setup

For easier management, create a docker-compose.yml:

version: '3.8'

services:
  open-notebook:
    image: ghcr.io/lfnovo/open-notebook:latest
    container_name: open-notebook
    restart: unless-stopped
    ports:
      - "8502:8502"
    environment:
      - OPENAI_COMPATIBLE_BASE_URL=https://api.tensorx.ai/v1
      - OPENAI_COMPATIBLE_API_KEY=your-tensorx-api-key
    volumes:
      - open-notebook-data:/data

volumes:
  open-notebook-data:

Deploy with:

docker compose up -d

---

Configuration

Environment Variables

Variable	Value	Description
OPENAI_COMPATIBLE_BASE_URL	https://api.tensorx.ai/v1	TensorX API endpoint
OPENAI_COMPATIBLE_API_KEY	Your API key	TensorX API key

OpenAI-compatible Configuration

TensorX exposes a standard OpenAI-compatible API, so configure Open Notebook to point at the TensorX endpoint with your TensorX key:

OPENAI_COMPATIBLE_BASE_URL=https://api.tensorx.ai/v1
OPENAI_COMPATIBLE_API_KEY=your-tensorx-api-key

You can also set these in the Open Notebook settings UI: choose the OpenAI Compatible provider, set the Base URL to https://api.tensorx.ai/v1, and paste your TensorX API key.

---

Setting Up Models in Open Notebook

After deployment:

1. Open http://localhost:8502 in your browser
2. Go to Settings → Models
3. Add a new model configuration:

Field	Value
Provider	OpenAI Compatible
Base URL	https://api.tensorx.ai/v1
API Key	Your TensorX API key
Model	deepseek/deepseek-chat-v3.1

1. Click Save and test the connection

---

Recommended Models

Use Case	Model	Notes
General chat	deepseek/deepseek-chat-v3.1	Fast, great for everyday use
Complex reasoning	deepseek/deepseek-r1-0528	Best for analysis and research
Coding assistance	z-ai/glm-5.1	Excellent for code-related tasks
Vision tasks	moonshotai/kimi-k2.5	Image understanding
Long documents	meta-llama/llama-4-maverick	Long document processing
Fast responses	meta-llama/llama-3.3-70b-instruct	Quick, cost-effective

---

Features with TensorX

📓 Notebooks

Organize your research into separate notebooks, each with its own sources and notes.

📄 Sources

Upload and process multiple content types:

• PDFs and documents
• YouTube videos
• Web pages
• Audio files

💬 Context-Aware Chat

Chat with your sources using TensorX models. The AI understands your uploaded content and provides cited answers.

🎙️ Podcast Generation

Transform your notes into engaging audio podcasts with multiple speakers. Configure TTS settings in Open Notebook to use TensorX's audio API.

🔍 Intelligent Search

Full-text and semantic search across all your content.

---

Podcast Generation Setup

To generate podcasts with TensorX TTS:

1. Go to Settings → Audio
2. Configure TTS provider:

Field	Value
TTS Provider	OpenAI Compatible
Base URL	https://api.tensorx.ai/v1
API Key	Your TensorX API key
Model	chatterbox-turbo

1. Create a podcast from any notebook or chat conversation

---

Troubleshooting

Models Not Loading

1. Verify your API key is correct
2. Check the base URL includes /v1: https://api.tensorx.ai/v1
3. Test your API key:

curl https://api.tensorx.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Connection Errors

1. Ensure Docker container is running: docker ps
2. Check logs: docker logs open-notebook
3. Verify network connectivity to api.tensorx.ai

Podcast Generation Fails

1. Ensure TTS is configured correctly in Settings
2. Check that your API key has sufficient credits
3. Verify the TTS model name is correct: chatterbox-turbo

---

Resources

• Open Notebook Documentation
• Open Notebook GitHub
• TensorX Models & Pricing
• TensorX Audio API

---

See Also

• Audio API - Text-to-speech and speech-to-text
• API Examples - Code examples for TensorX API
• Troubleshooting - Common issues and fixes