# Open Notebook: NotebookLM tự host, chọn AI tuỳ ý — hướng dẫn cài đặt và dùng

> Open Notebook là ứng dụng ghi chú và nghiên cứu bằng AI, mã nguồn mở theo giấy phép MIT, làm việc theo kiểu Google NotebookLM nhưng bạn tự chạy trên máy mình. Bạn đưa tài liệu vào, hỏi đáp có trích nguồn, tạo ghi chú và podcast. Cài bằng Docker với vài lệnh, người mới làm theo được trong khoảng 10-15 phút.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-04-29 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/open-notebook-notebooklm-ma-nguon-tu-host-huong-dan-cai-dat

Open Notebook là một ứng dụng web mã nguồn mở để nghiên cứu và ghi chú cùng AI, theo kiểu Google NotebookLM nhưng chạy trên máy hoặc máy chủ của chính bạn. Bạn gom tài liệu (PDF, video, âm thanh, trang web, tài liệu Office…) vào từng "notebook", rồi hỏi đáp, tóm tắt, tạo ghi chú và tạo podcast từ chính những tài liệu đó.

Vấn đề nó giải quyết khá rõ: nhiều người muốn dùng AI để đọc tài liệu nhưng ngại đưa hồ sơ nội bộ, báo cáo khách hàng hay tài liệu nghiên cứu lên dịch vụ đám mây của một hãng duy nhất. Với Open Notebook, dữ liệu nằm ở máy bạn. Bạn cũng tự chọn "bộ não" AI: OpenAI, Anthropic, Google, Mistral, hoặc mô hình chạy cục bộ như Ollama. Nếu dùng mô hình cục bộ, theo README thì không có gì rời khỏi máy bạn.

Repo hiện có khoảng 41.900 sao và 4.800 fork, giấy phép MIT, vẫn được cập nhật trong vài tháng gần đây. Điểm đáng giá nhất: cài bằng Docker chỉ vài lệnh, rồi nhập API key ngay trên giao diện web, không phải sửa file cấu hình. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi cài.

```repo
- repo | lfnovo/open-notebook
- kind | Ứng dụng
- desc | Open Notebook là bản mã nguồn mở thay thế Google NotebookLM: tự cài trên máy, chọn AI tuỳ ý, hỏi đáp có trích nguồn và tạo podcast nhiều giọng.
- stars | 42k
- lang | TypeScript
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/z-JaUqipywI
- facebook | https://www.facebook.com/reel/1146033424433382
- title | Video giới thiệu open-notebook
```

## Open Notebook làm được gì

Dưới đây là những tính năng chính theo README, kèm lợi ích thực tế.

### Gom nhiều loại tài liệu vào một chỗ

Bạn tạo nhiều notebook, mỗi notebook ứng với một dự án hoặc chủ đề. README nói repo hỗ trợ PDF, video, âm thanh, trang web, tài liệu Office và nhiều loại khác. Lợi ích: thay vì mở mười cửa sổ khác nhau, bạn có một nơi duy nhất để AI đọc toàn bộ tư liệu của một dự án.

### Chọn nhà cung cấp AI tuỳ ý

README ghi hơn 20 nhà cung cấp, gồm OpenAI, Anthropic, Google, Groq, Mistral, DeepSeek, xAI, OpenRouter, Ollama, Azure OpenAI, Vertex AI và mọi máy chủ tương thích OpenAI như LM Studio. Lợi ích: bạn chuyển sang nhà cung cấp rẻ hơn hoặc chạy mô hình cục bộ để khỏi tốn tiền API, không bị khoá vào một hãng.

### Hỏi đáp có ngữ cảnh và trích nguồn

Bạn trò chuyện với AI dựa trên chính tài liệu đã nạp. Câu trả lời có trích dẫn nguồn, ghi chú và insight đã dùng. Bạn còn chọn được chính xác phần nào được chia sẻ cho AI (README gọi là "fine-grained context control"), nên không phải đưa cả kho tài liệu mỗi lần hỏi.

### Tìm kiếm toàn văn và tìm theo ngữ nghĩa

App hỗ trợ tìm kiếm full-text và vector search trên toàn bộ nội dung. Nhớ mang máng một ý trong tài liệu nào đó thì bạn vẫn tìm ra được.

### Ghi chú có AI hỗ trợ và "transformations"

Bạn có thể tự viết ghi chú hoặc để AI sinh insight. Phần Content Transformations cho phép tạo các thao tác xử lý riêng (tóm tắt, rút ý chính…), có sẵn hoặc do bạn tự định nghĩa.

### Podcast nhiều giọng

Tạo podcast từ tài liệu với 1-4 người nói, mỗi người có hồ sơ riêng (Episode Profiles). README so sánh: NotebookLM chỉ có 2 người nói.

### Có REST API và giao diện đa ngôn ngữ

App có REST API đầy đủ để tự động hoá, và giao diện có nhiều ngôn ngữ (README liệt kê tiếng Anh, Trung, Pháp, Đức, Nhật, Bồ Đào Nha, Nga, Tây Ban Nha, Thổ Nhĩ Kỳ…; danh sách trong tư liệu không có tiếng Việt). Ngoài ra repo có hỗ trợ tuỳ chọn đặt mật khẩu và tích hợp MCP với Claude Desktop, VS Code.

## Cần chuẩn bị gì

Theo README, bạn chỉ cần hai thứ:

- **Docker Desktop** nếu dùng macOS hoặc Windows, hoặc Docker Engine kèm Compose plugin nếu dùng Linux.
- **Một API key** từ nhà cung cấp AI, hoặc một máy chủ mô hình cục bộ như Ollama. Key được nhập trên giao diện web, không điền vào file cấu hình.

README không nêu yêu cầu cấu hình phần cứng cụ thể cho cách cài bằng Docker, nên mình không đoán. Nếu định chạy mô hình cục bộ bằng Ollama, bạn nên xem hướng dẫn Ollama trong thư mục docs của repo trước.

Nếu chọn Anthropic hoặc Groq, lưu ý hai bên này không có mô hình embedding. Bạn cần ghép thêm một nhà cung cấp có embedding (ví dụ OpenAI hoặc Google) để tìm kiếm theo ngữ nghĩa hoạt động.

Một điều nữa: pyproject.toml của repo yêu cầu Python từ 3.11 đến dưới 3.13. Con số này chỉ cần quan tâm khi bạn cài từ mã nguồn để phát triển. Nếu chạy bằng Docker, bạn không phải cài Python.

## Cài đặt từng bước

```steps
- Tải file cấu hình | Tạo thư mục open-notebook và tải docker-compose.yml về
- Đặt khoá mã hoá | Sửa dòng OPEN_NOTEBOOK_ENCRYPTION_KEY thành chuỗi bí mật của bạn
- Khoá cổng hoặc đặt mật khẩu | Nếu máy nằm trong mạng chung, giới hạn cổng hoặc thêm mật khẩu
- Khởi động | Chạy docker compose up -d rồi mở http://localhost:8502
- Kết nối AI | Thêm API key và chọn model ngay trong giao diện
```

### Tải file docker-compose.yml

Mở terminal (macOS/Linux dùng Terminal, Windows dùng PowerShell hoặc Git Bash) tại nơi bạn muốn đặt dự án, rồi chạy:

```bash
mkdir open-notebook && cd open-notebook
curl -o docker-compose.yml https://raw.githubusercontent.com/lfnovo/open-notebook/main/docker-compose.yml
```

Dòng đầu tạo thư mục và đi vào trong. Dòng thứ hai tải file docker-compose.yml chính thức của repo. File này chạy hai dịch vụ: `surrealdb` (cơ sở dữ liệu) và `open_notebook` (giao diện, API và tiến trình nền).

Chỗ người mới hay vấp: trên Windows PowerShell bản cũ, toán tử `&&` có thể không chạy. Bạn cứ chạy từng dòng riêng, hoặc dùng Git Bash. Lệnh `curl` trong PowerShell đôi khi là bí danh của một lệnh khác; nếu báo lỗi lạ, bạn dùng Git Bash hoặc tự tải file về từ đường dẫn trên rồi lưu với tên docker-compose.yml.

### Đặt khoá mã hoá

Mở file docker-compose.yml bằng trình soạn thảo bất kỳ, tìm dòng này:

```yaml
- OPEN_NOTEBOOK_ENCRYPTION_KEY=change-me-to-a-secret-string
```

Đổi phần sau dấu `=` thành một chuỗi bí mật dài do bạn tự tạo. README gợi ý tạo bằng lệnh:

```bash
openssl rand -hex 32
```

Khoá này dùng để mã hoá các API key bạn lưu trong app. Hãy cất nó ở nơi an toàn.

```note
Đừng để nguyên chuỗi change-me-to-a-secret-string. Và hãy ghi lại khoá bạn đã đặt: README nhấn mạnh phải giữ nó, vì đó là chìa khoá mã hoá các API key lưu trong app.
```

### Khoá cổng hoặc đặt mật khẩu (nếu máy dùng chung mạng)

Theo README, giao diện (cổng 8502) và API (cổng 5055) mở trên mọi giao diện mạng và mặc định không có mật khẩu. Nếu thiết bị khác trong mạng có thể truy cập máy bạn, hãy đổi hai dòng cổng trong file thành:

```yaml
"127.0.0.1:8502:8502"
"127.0.0.1:5055:5055"
```

Hoặc thêm một dòng vào khối `environment:`:

```yaml
- OPEN_NOTEBOOK_PASSWORD=your-password
```

Thay `your-password` bằng mật khẩu của bạn. Làm việc này trước khi khởi động.

### Khởi động dịch vụ

Trong cùng thư mục có file docker-compose.yml, chạy:

```bash
docker compose up -d
```

Lệnh này tải ảnh Docker và chạy ngầm. Đợi khoảng 30 giây rồi mở trình duyệt vào:

```text
http://localhost:8502
```

Nhớ bật Docker Desktop trước khi chạy lệnh, nếu không bạn sẽ gặp lỗi không kết nối được tới Docker.

### Kết nối nhà cung cấp AI

Phần này làm trong giao diện web, theo README:

1. Ở thanh bên, mở **Models** (mục Manage).
2. Tìm nhà cung cấp của bạn (OpenAI, Anthropic, Google…) và bấm **Add Configuration**.
3. Nhập tên và API key (nhà cung cấp cục bộ như Ollama thì nhập **Base URL**), rồi bấm **Add Configuration**.
4. Bấm **Test** trên cấu hình vừa tạo để kiểm tra kết nối.
5. Bấm **Models**, chọn **Model Type**, tick các model muốn thêm và bấm **Add**. Cần thêm ít nhất một model **Language** và một model **Embedding**.
6. Ở mục **Default Model Assignments**, bấm **Auto-assign Defaults** (hoặc tự chọn).

Xong là bạn có thể tạo notebook, thêm nguồn và bắt đầu trò chuyện.

## Kiểm tra đã chạy được chưa

Có ba dấu hiệu cho biết mọi thứ ổn:

- Sau khoảng 30 giây, trang `http://localhost:8502` mở ra giao diện Open Notebook.
- Ở bước kết nối AI, bấm **Test** trên cấu hình vừa thêm và kết nối được kiểm tra thành công.
- Bạn tạo được một notebook, thêm một nguồn, rồi chat và nhận được câu trả lời.

Nếu muốn xem container có đang chạy không, bạn có thể dùng lệnh Docker phổ thông:

```bash
docker compose ps
```

Lệnh này liệt kê các dịch vụ trong thư mục hiện tại. Bạn nên thấy hai dịch vụ `surrealdb` và `open_notebook` ở trạng thái đang chạy.

## Dùng vào việc thật

Dưới đây là những tình huống bám đúng khả năng repo mô tả. Các câu hỏi mẫu là gợi ý của mình, bạn chỉnh theo nhu cầu.

### Nhân viên văn phòng: đọc nhanh bộ hồ sơ dày

Bạn nhận một bộ báo cáo và vài file PDF hợp đồng cần đọc gấp trước buổi họp. Tạo một notebook tên "Họp thứ Sáu", thêm các file PDF làm nguồn, rồi hỏi:

```text
Tóm tắt các điều khoản về thanh toán và phạt vi phạm trong các tài liệu này, nói rõ điều khoản nằm ở tài liệu nào.
```

Kết quả: một bản tóm tắt có trích nguồn, bạn bấm vào để đối chiếu với tài liệu gốc. Dữ liệu chỉ nằm trên máy bạn (chỉ nội dung gửi tới nhà cung cấp AI bạn chọn khi hỏi, trừ khi bạn dùng mô hình cục bộ).

> Cái hay của Open Notebook là bạn tự quyết dữ liệu đi đâu và AI nào đọc nó.
>
> — Ông T

### Chủ shop: gom tư liệu sản phẩm và tìm lại nhanh

Bạn có tài liệu nhà cung cấp, bảng thông số, vài trang web đối thủ và video giới thiệu. Thêm tất cả vào một notebook, rồi dùng ô tìm kiếm hoặc hỏi: "Sản phẩm nào có chế độ bảo hành dài nhất?". Nhờ tìm kiếm toàn văn và tìm theo ngữ nghĩa, bạn không cần nhớ chính xác từ khoá. Kết quả là câu trả lời kèm nguồn, tiện để soạn mô tả sản phẩm hoặc trả lời khách.

### Người học tập: biến tài liệu thành ghi chú và podcast

Bạn đang học một chủ đề mới từ vài bài viết và một video. Thêm chúng làm nguồn, dùng một transformation để tóm tắt hoặc rút ý chính, lưu thành ghi chú. Sau đó thử tính năng podcast: chọn số người nói (1-4) và hồ sơ tập (Episode Profile) để nghe lại nội dung như một chương trình trò chuyện. Lưu ý: podcast cần model giọng nói (text-to-speech) từ một nhà cung cấp có hỗ trợ, bạn xem bảng nhà cung cấp trong README để chọn.

### Lập trình viên: tích hợp qua API hoặc MCP

Bạn muốn đưa Open Notebook vào quy trình riêng. README cho biết có REST API đầy đủ và phần tích hợp MCP với Claude Desktop, VS Code. Hướng dẫn chi tiết nằm trong thư mục docs của repo (mục API Reference và MCP Integration). Phần này mình khuyên bạn đọc tài liệu đó trước khi viết code, vì README chính không liệt kê các endpoint cụ thể.

## Lỗi hay gặp và cách xử lý

### Mở localhost:8502 không thấy gì

Nguyên nhân thường là ứng dụng chưa khởi động xong. README dặn đợi khoảng 30 giây. Nếu vẫn không lên, kiểm tra Docker Desktop đã bật chưa và chạy `docker compose ps` xem hai dịch vụ có đang chạy không. Có thể xem nhật ký bằng lệnh Docker phổ thông `docker compose logs`.

### Hỏi đáp báo lỗi hoặc không tìm kiếm được

Hay gặp khi bạn mới thêm model Language mà chưa thêm model **Embedding**. README yêu cầu có cả hai. Vào mục Models, thêm một model Embedding rồi bấm **Auto-assign Defaults** ở phần Default Model Assignments. Nếu bạn dùng Anthropic hoặc Groq, nhớ rằng hai bên này không có embedding, phải ghép với nhà cung cấp khác.

### Bấm Test báo kết nối thất bại

Kiểm tra lại API key đã dán đúng chưa (không thừa khoảng trắng) và tài khoản nhà cung cấp còn hạn mức không. Với Ollama hoặc máy chủ cục bộ, bạn phải nhập **Base URL** thay vì key, và máy chủ đó phải đang chạy. README chưa nêu địa chỉ cụ thể cho trường hợp Ollama chạy trong Docker, nên bạn xem hướng dẫn Ollama trong thư mục docs.

### Quên khoá mã hoá hoặc lỡ đổi khoá

Khoá `OPEN_NOTEBOOK_ENCRYPTION_KEY` dùng để mã hoá API key đã lưu. Mình không có thông tin chi tiết về việc khôi phục khi mất khoá, nhưng an toàn nhất là ghi lại khoá ngay từ đầu và không đổi nó sau khi đã nhập key. Nếu lỡ đổi, bạn nên nhập lại các cấu hình nhà cung cấp.

### Người khác trong mạng truy cập được app của bạn

Đây là hệ quả của cấu hình mặc định: cổng mở trên mọi giao diện mạng, không có mật khẩu. Sửa hai dòng cổng thành `127.0.0.1` hoặc thêm `OPEN_NOTEBOOK_PASSWORD` như ở phần cài đặt, rồi chạy lại `docker compose up -d`.

## Có nên dùng không

**Điểm mạnh.** Bạn kiểm soát dữ liệu, chọn được nhà cung cấp AI, và chỉ trả tiền cho phần AI bạn dùng (hoặc chạy cục bộ để không tốn phí API). Podcast linh hoạt hơn (1-4 người nói), có REST API để tự động hoá, giấy phép MIT, cộng đồng lớn với nhiều sao và đang được cập nhật. Cài đặt bằng Docker khá gọn.

**Giới hạn.** Bạn phải tự chạy và tự bảo trì: cập nhật, sao lưu, bảo mật mạng. Phải có Docker. Giao diện theo danh sách trong README chưa có tiếng Việt, nên bạn dùng bản tiếng Anh hoặc một ngôn ngữ khác. README cũng nói rõ repo đang tập trung làm vững phần lõi (nguồn, chat, tìm kiếm, ghi chú, podcast) trước khi thêm tính năng mới, và các hướng như hỗ trợ nhiều người dùng mới chỉ là định hướng, chưa phải lời hứa. Vì vậy, nếu cần quản lý nhiều tài khoản trong một đội, hãy kiểm tra kỹ trước.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ cần thử nhanh vài tài liệu, không muốn cài gì, thì dịch vụ có sẵn như Google NotebookLM có thể tiện hơn. Nếu tài liệu rất nhạy cảm, hãy dùng mô hình cục bộ qua Ollama, vì dùng API đám mây thì nội dung bạn hỏi vẫn được gửi tới nhà cung cấp đó. Còn nếu bạn thích kiểm soát, muốn linh hoạt chọn AI và tự host, Open Notebook là lựa chọn rất đáng thử.

## Câu hỏi thường gặp

### Open Notebook có miễn phí không?

Phần mềm là mã nguồn mở theo giấy phép MIT nên không mất phí bản quyền. Bạn chỉ trả tiền cho phần AI nếu dùng API của nhà cung cấp đám mây. README nói bạn có thể chạy mô hình cục bộ qua Ollama để không tốn chi phí API.

### Cài Open Notebook có cần GPU không?

README không nêu yêu cầu GPU hay cấu hình phần cứng cho cách cài bằng Docker. Nếu bạn dùng API của nhà cung cấp đám mây thì việc nặng nằm ở phía họ. Với mô hình cục bộ qua Ollama, yêu cầu phần cứng tuỳ mô hình bạn chọn; tư liệu chưa có thông tin cụ thể.

### Open Notebook chạy trên Windows được không?

Được. README nêu Docker Desktop cho macOS và Windows, Docker Engine kèm Compose plugin cho Linux. Bạn cài Docker rồi làm theo các lệnh docker compose như hướng dẫn.

### Dữ liệu của tôi có an toàn không?

Ứng dụng được tự host, nên tài liệu nằm trên máy hoặc máy chủ của bạn. README nói với mô hình cục bộ thì không có gì rời khỏi máy bạn. Nếu dùng API đám mây, nội dung bạn hỏi sẽ gửi tới nhà cung cấp đó. Mặc định app không có mật khẩu, nên bạn cần khoá cổng hoặc đặt OPEN_NOTEBOOK_PASSWORD nếu máy dùng chung mạng.

### Open Notebook khác gì Google NotebookLM?

Theo README, Open Notebook là tự host, chọn được hơn 20 nhà cung cấp AI, podcast từ 1-4 người nói (NotebookLM là 2), có REST API và có thể tuỳ biến vì là mã nguồn mở. NotebookLM chạy trên đám mây của Google và chỉ dùng mô hình của Google.

### Tôi cần nhập API key ở đâu?

Bạn nhập ngay trên giao diện web, trong mục Models, bấm Add Configuration, không phải điền vào file cấu hình. Các key được mã hoá bằng khoá OPEN_NOTEBOOK_ENCRYPTION_KEY mà bạn đặt trong docker-compose.yml.

### Có hỗ trợ tiếng Việt không?

Danh sách ngôn ngữ giao diện trong README không có tiếng Việt. Tư liệu cũng chưa nói về chất lượng xử lý tiếng Việt, việc này phụ thuộc vào mô hình AI bạn chọn.
