> For the complete documentation index, see [llms.txt](https://docs.tensorx.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tensorx.ai/research-and-knowledge/open-notebook.md).

# 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](https://www.open-notebook.ai/) 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.

{% hint style="success" %}
**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
  {% endhint %}

***

## Prerequisites

* Docker installed on your system
* A TensorX API key ([sign up here](https://app.tensorx.ai))
* At least 4GB RAM and 10GB disk space

***

## Quick Start with Docker

Deploy Open Notebook with TensorX in one command:

```bash
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
```

{% hint style="warning" %}
**Replace** `your-tensorx-api-key` with your actual TensorX API key!
{% endhint %}

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

***

## Docker Compose Setup

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

```yaml
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:

```bash
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:

```bash
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` |

4. 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`          |

3. 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:

```bash
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](https://www.open-notebook.ai/)
* [Open Notebook GitHub](https://github.com/lfnovo/open-notebook)
* [TensorX Models & Pricing](https://tensorx.ai/models)
* [TensorX Audio API](/api-reference/audio.md)

***

## See Also

* [Audio API](/api-reference/audio.md) - Text-to-speech and speech-to-text
* [API Examples](/api-reference/api-examples.md) - Code examples for TensorX API
* [Troubleshooting](/support/troubleshooting.md) - Common issues and fixes


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tensorx.ai/research-and-knowledge/open-notebook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.