# Open Notebook: trợ lý ghi chú nghiên cứu tự host thay Notebook LM — hướng dẫn cài đặt và dùng

> Open Notebook là ứng dụng mã nguồn mở, giống Notebook LM của Google nhưng bạn tự chạy trên máy hoặc server của mình. Bạn gom PDF, video, âm thanh, trang web vào một sổ tay rồi chat, tìm kiếm, ghi chú và tạo podcast từ chúng. Cài bằng Docker khá đơn giản: tải một file, đổi một dòng, chạy một lệnh.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-04-30 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/open-notebook-tro-ly-nghien-cuu-tu-host-thay-notebook-lm

Open Notebook là một ứng dụng mã nguồn mở để nghiên cứu và ghi chú có AI hỗ trợ, được làm như một lựa chọn thay cho Notebook LM của Google. Bạn gom tài liệu (PDF, video, âm thanh, trang web, file Office) vào một "sổ tay", rồi hỏi đáp, tìm kiếm, ghi chú và tạo podcast từ chính những tài liệu đó. Điểm khác là ứng dụng chạy trên máy hoặc server của bạn, không nằm trên đám mây của một hãng.

Nếu bạn hay phải đọc nhiều tài liệu dài, như báo cáo, hợp đồng, bài nghiên cứu hay video bài giảng, và ngại đưa dữ liệu lên dịch vụ của bên khác, repo này dành cho bạn. Chủ shop, nhân viên văn phòng, sinh viên hay lập trình viên đều dùng được. Repo hiện có khoảng 41.896 sao và 4.820 fork, giấy phép MIT.

Điểm đáng giá nhất là bạn tự chọn "bộ não" AI. README nói hỗ trợ hơn 20 nhà cung cấp như OpenAI, Anthropic, Google, Mistral, Ollama và mọi máy chủ tương thích OpenAI (như LM Studio, vLLM). Bạn có thể trả tiền theo lượng dùng, hoặc chạy mô hình cục bộ để dữ liệu không rời máy. 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ở của Notebook LM: tự chạy trên máy bạn, chat với tài liệu, ghi chú, tạo podcast, chọn được hơn 20 nhà cung cấp AI.
- 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à các tính năng chính, kèm lợi ích thực tế.

- **Nhiều sổ tay cho nhiều dự án.** Mỗi chủ đề (một khách hàng, một khoá học, một đề tài) có một sổ tay riêng. Tài liệu không lẫn vào nhau, nên khi hỏi AI chỉ trả lời dựa trên đúng bộ tài liệu đó.
- **Nhận nhiều loại nguồn.** PDF, video, âm thanh, trang web, tài liệu Office và các định dạng khác. Bạn không phải đổi định dạng trước khi nạp vào.
- **Chat có ngữ cảnh và có trích dẫn.** AI trả lời dựa trên tài liệu của bạn và ghi rõ đã dùng nguồn, ghi chú hay insight nào. Bạn kiểm tra lại được thay vì tin mù quáng.
- **Kiểm soát cái gì được gửi cho AI.** README gọi là điều khiển ngữ cảnh chi tiết: bạn chọn chính xác phần nào được chia sẻ với mô hình. Việc này vừa giữ riêng tư, vừa tiết kiệm chi phí.
- **Tìm kiếm thông minh.** Có cả tìm toàn văn lẫn tìm theo vector trên toàn bộ nội dung. Bạn gõ ý, không nhất thiết phải nhớ đúng từ khoá.
- **Ghi chú có AI hỗ trợ.** Bạn tự viết ghi chú, hoặc nhờ AI sinh insight từ nguồn.
- **Biến đổi nội dung (Content Transformations).** Các thao tác dựng sẵn hoặc tự tạo để tóm tắt, rút ý chính. Làm một lần, áp dụng cho nhiều tài liệu.
- **Podcast nhiều người nói.** Tạo podcast với 1 đến 4 người nói, có hồ sơ riêng cho từng người. README so sánh: Notebook LM chỉ có 2 người.
- **Hỗ trợ mô hình suy luận.** Có hỗ trợ các mô hình dạng "thinking" như DeepSeek-R1 và Qwen3.
- **REST API đầy đủ.** Lập trình viên có thể tự động hoá, tích hợp vào hệ thống khác. README cũng nhắc đến tích hợp MCP để kết nối với Claude Desktop, VS Code và các MCP client khác.
- **Giao diện đa ngôn ngữ.** Danh sách trong README gồm tiếng Anh, Trung, Pháp, Đức, Nhật, Nga, Tây Ban Nha, Thổ Nhĩ Kỳ và một số thứ tiếng khác. README không liệt kê tiếng Việt, nên bạn nên chuẩn bị dùng giao diện tiếng Anh.
- **Bảo vệ bằng mật khẩu (tuỳ chọn).** Hữu ích nếu bạn đặt ứng dụng trên server dùng chung.

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

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

- **Docker.** Dùng Docker Desktop nếu bạn ở macOS hoặc Windows. Ở Linux dùng Docker Engine kèm plugin Compose.
- **Một nguồn AI.** Đó là API key của mộ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 trong giao diện web, không phải điền vào file cấu hình.

Về phần cứng, README phần Quick Start không nói yêu cầu cụ thể (RAM, GPU). Nếu bạn định chạy mô hình cục bộ qua Ollama, hãy xem hướng dẫn riêng "Local Quick Start" trong thư mục docs của repo để biết thêm.

Còn một điều cần lưu ý về mô hình. README yêu cầu thêm ít nhất một mô hình **Language** (ngôn ngữ) và một mô hình **Embedding** (dùng cho tìm kiếm theo vector). Anthropic và Groq không có mô hình embedding, nên nếu bạn chọn hai bên này, hãy ghép thêm một nhà cung cấp có embedding (ví dụ OpenAI, Google hoặc Ollama theo bảng trong README).

README cũng dẫn tới trang lấy API key của OpenAI, Anthropic, Google và Groq. Bạn tự đăng ký tài khoản bên đó.

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

```steps
- Tạo thư mục và tải file | Tạo thư mục open-notebook rồi tải docker-compose.yml chính thức về
- Đặt khoá mã hoá | Sửa dòng OPEN_NOTEBOOK_ENCRYPTION_KEY trong docker-compose.yml
- Khởi động dịch vụ | Chạy docker compose up -d rồi chờ khoảng 30 giây
- Mở giao diện web | Vào http://localhost:8502
- Kết nối nhà cung cấp AI | Thêm API key, thêm mô hình, gán mô hình mặc định
```

### Tạo thư mục và tải file docker-compose.yml

Mở terminal (Windows: PowerShell hoặc Git Bash; macOS/Linux: Terminal). Chạy hai lệnh sau trong README:

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

Lệnh đầu tạo thư mục `open-notebook` và đi vào trong đó. Lệnh 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: nếu bạn dùng PowerShell trên Windows, `&&` có thể không chạy ở các bản cũ. Khi đó hãy gõ từng lệnh một, hoặc dùng Git Bash. Bạn chỉ cần Docker và một file này, không cần clone cả repo.

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

Mở file `docker-compose.yml` bằng trình soạn thảo bất kỳ và 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 sau (cần máy có `openssl`):

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

Khoá này dùng để mã hoá các API key bạn lưu trong ứng dụng. Hãy cất giữ nó cẩn thận.

```note
Mặc định giao diện (cổng 8502) và API (cổng 5055) mở trên mọi giao diện mạng và KHÔNG có mật khẩu. Nếu máy bạn nằm trong mạng dùng chung hoặc là server, hãy làm một trong hai việc trước khi khởi động: đổi hai dòng cổng thành 127.0.0.1:8502:8502 và 127.0.0.1:5055:5055, hoặc thêm dòng OPEN_NOTEBOOK_PASSWORD=mật-khẩu-của-bạn vào phần environment. Đừng đưa API key của bạn cho người không tin tưởng.
```

Nếu bạn chọn cách giới hạn cổng, hai dòng trong file sẽ có dạng như README mô tả:

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

Cách còn lại là thêm một dòng vào khối `environment:`:

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

Hãy đổi `your-password` thành mật khẩu thật của bạn. Cẩn thận với thụt lề: file YAML rất nhạy với khoảng trắng, nên hãy thụt dòng mới thẳng hàng với các dòng `-` bên cạnh.

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

Đảm bảo Docker Desktop đã mở và đang chạy. Rồi chạy lệnh sau trong thư mục `open-notebook`:

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

Lệnh này tải các hình ảnh (image) cần thiết và chạy hai dịch vụ ở chế độ nền. Lần đầu có thể mất vài phút để tải. README bảo chờ khoảng 30 giây rồi mở trình duyệt vào **http://localhost:8502**.

### 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** (nằm dưới 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 một cái tên và API key. Với nhà cung cấp cục bộ như Ollama, bạn nhập **Base URL** thay cho key. 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**, tích các mô hình muốn thêm rồi bấm **Add**. Hãy thêm ít nhất một mô hình **Language** và một mô hình **Embedding**.
6. Ở mục **Default Model Assignments**, bấm **Auto-assign Defaults** (hoặc tự chọn mô hình).

Xong là bạn tạo sổ tay, thêm nguồn và bắt đầu chat.

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

Có ba dấu hiệu cho thấy bạn đã cài thành công:

- Trình duyệt mở được **http://localhost:8502** và hiện giao diện Open Notebook.
- Ở trang **Models**, bấm **Test** trên cấu hình nhà cung cấp và kết nối báo thành công.
- Bạn tạo một notebook, thêm một nguồn (ví dụ một file PDF ngắn), hỏi một câu về nội dung và nhận câu trả lời.

Nếu trang không mở ngay, hãy chờ thêm một lúc rồi tải lại, vì README nói cần khoảng 30 giây. Bạn cũng có thể xem trạng thái hai dịch vụ bằng lệnh Docker phổ thông này:

```bash
docker compose ps
```

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

### Chủ shop đọc nhanh báo giá và hợp đồng nhà cung cấp

Bạn nhận ba bản báo giá PDF từ ba nhà cung cấp và không có thời gian đọc hết. Tạo một sổ tay tên "Chọn nhà cung cấp", thêm cả ba file vào. Rồi hỏi trong khung chat:

```text
So sánh ba báo giá về giá, thời gian giao hàng và điều khoản đổi trả. Trình bày dạng bảng và ghi rõ lấy từ file nào.
```

Bạn nhận lại bảng so sánh kèm trích dẫn nguồn. Bạn bấm vào trích dẫn để kiểm tra lại con số quan trọng trước khi quyết định. Điều khoản nhạy cảm nên được bạn đọc lại bằng mắt, đừng tin hoàn toàn vào bản tóm tắt.

### Nhân viên văn phòng tóm tắt tài liệu dài bằng Transformations

Cuối tuần bạn có một chồng báo cáo và biên bản họp cần tóm tắt cho sếp. Thêm các file vào sổ tay, dùng tính năng **Content Transformations** để chạy một thao tác tóm tắt dựng sẵn lên từng nguồn. Kết quả là insight hoặc bản tóm tắt gắn với từng tài liệu. Bạn lưu thành ghi chú, chỉnh lại bằng lời của mình rồi gửi đi.

> Bạn tự quyết AI nào đọc tài liệu của mình, và có thể chọn để dữ liệu không rời khỏi máy.
>
> — Ông T

### Người học và làm nội dung biến tài liệu thành podcast

Bạn đang học một chủ đề khó và thích nghe hơn đọc. Thêm các bài viết, PDF và video liên quan vào sổ tay rồi dùng tính năng tạo podcast. Bạn chọn số người nói (từ 1 đến 4) và dùng hồ sơ tập (Episode Profiles) để định hình giọng điệu. Bạn nhận về một tập podcast từ chính tài liệu đã nạp, nghe được khi đi đường.

Lưu ý: tạo podcast cần mô hình text-to-speech. Theo bảng của README, OpenAI, Google, Mistral, ElevenLabs và một số bên khác có hỗ trợ. Anthropic thì không. Hãy kiểm tra bảng trước khi chọn.

### Lập trình viên nối Open Notebook vào quy trình riêng

Nếu bạn là dev, README cho biết có REST API đầy đủ (cổng 5055 trong cấu hình mặc định) và tích hợp MCP để các công cụ như Claude Desktop hay VS Code làm việc với Open Notebook. Bạn có thể tự động nạp tài liệu mới vào sổ tay, hoặc để một agent truy vấn kho ghi chú của mình. Chi tiết endpoint nằm trong tài liệu "REST API Reference" trong thư mục docs của repo. Mình không chép lại ở đây để tránh sai.

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

### Lệnh docker compose báo lỗi hoặc không kết nối được Docker

Thường là Docker Desktop chưa mở. Hãy mở Docker Desktop, chờ nó báo đã chạy xong rồi chạy lại `docker compose up -d`. Trên Linux, kiểm tra đã cài plugin Compose chưa.

### Mở localhost:8502 nhưng trang không lên

Có thể dịch vụ chưa khởi động xong (README nói chờ khoảng 30 giây). Hãy đợi rồi tải lại trang. Nếu vẫn không được, chạy `docker compose ps` để xem hai dịch vụ có đang chạy không, và `docker compose logs` để xem thông báo lỗi. Cổng 8502 hoặc 5055 bị chương trình khác chiếm cũng là một nguyên nhân dễ gặp. Khi đó hãy tắt chương trình kia hoặc đổi cổng trong `docker-compose.yml`.

### Chat hoặc tìm kiếm không hoạt động dù đã nhập key

Hãy quay lại trang **Models** và kiểm tra ba điều: đã bấm **Test** và báo thành công chưa; đã thêm ít nhất một mô hình Language và một mô hình Embedding chưa; đã gán mô hình ở **Default Model Assignments** chưa. Lỗi hay gặp là chỉ chọn Anthropic hoặc Groq, hai bên này không có embedding, nên bạn cần thêm một nhà cung cấp có embedding.

### Mất API key đã lưu sau khi đổi cấu hình

API key bạn nhập được mã hoá bằng `OPEN_NOTEBOOK_ENCRYPTION_KEY`. Nếu bạn đổi hoặc làm mất khoá này, ứng dụng không còn giải mã được các key đã lưu. Hãy ghi lại khoá ở nơi an toàn ngay từ đầu. Nếu lỡ đổi, bạn cần nhập lại API key.

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

Đây không hẳn là lỗi mà là cấu hình mặc định: không có mật khẩu và cổng mở trên mọi giao diện. Hãy giới hạn cổng về 127.0.0.1 hoặc đặt `OPEN_NOTEBOOK_PASSWORD` như đã hướng dẫn ở phần cài đặt, rồi khởi động lại dịch vụ.

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

**Điểm mạnh.** Bạn giữ quyền kiểm soát dữ liệu vì ứng dụng tự host. Bạn không bị khoá vào một hãng AI: đổi nhà cung cấp, chạy cục bộ bằng Ollama, hoặc dùng cả hai tuỳ việc. Chi phí là phần bạn trả cho AI theo mức dùng, theo cách README mô tả. Podcast nhiều người nói và REST API là hai thứ mà bản của Google không có, theo bảng so sánh trong README. Giấy phép MIT cho phép bạn sửa và mở rộng thoải mái.

**Giới hạn.** Bạn phải tự cài và tự vận hành, nghĩa là biết dùng terminal và Docker ở mức cơ bản. Giao diện không có tiếng Việt trong danh sách README. Chất lượng câu trả lời và podcast phụ thuộc vào mô hình bạn chọn. README chưa nêu yêu cầu phần cứng cụ thể cho chạy cục bộ, nên bạn cần tự thử. README cũng nói hướng đa người dùng mới là "hướng đang cân nhắc" chứ chưa phải lời hứa, nên nếu cả công ty cùng dùng với phân quyền riêng, hãy cân nhắc kỹ.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần thỉnh thoảng hỏi vài file và không muốn cài gì, dịch vụ đám mây có sẵn sẽ nhanh hơn. Nếu bạn cần dữ liệu tuyệt đối không rời máy mà máy yếu, hãy thử cấu hình cục bộ cẩn thận trước khi cam kết. Còn nếu bạn muốn làm chủ dữ liệu, tuỳ chọn mô hình và có thể tích hợp tự động hoá, Open Notebook là lựa chọn đáng thử.

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

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

Bản thân phần mềm là mã nguồn mở, giấy phép MIT, bạn tải và dùng không mất phí. Chi phí phát sinh là tiền AI nếu bạn dùng nhà cung cấp tính phí. README mô tả là bạn chỉ trả cho lượng AI dùng, và có thể chạy mô hình cục bộ với Ollama để không tốn phí API.

### Có cần GPU không?

README phần Quick Start không nêu yêu cầu GPU hay RAM. Nếu bạn dùng API của OpenAI, Google... thì mô hình chạy ở phía nhà cung cấp. Nếu chạy cục bộ bằng Ollama, hãy xem hướng dẫn Local Quick Start trong tài liệu của repo vì chưa có thông tin cụ thể ở đây.

### Chạy trên Windows được không?

Được theo README: Windows và macOS dùng Docker Desktop, Linux dùng Docker Engine với plugin Compose. Cài đặt chính thức đi qua Docker, nên bạn không cần cài Python hay Node riêng.

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

Ứng dụng tự host nên dữ liệu nằm trên máy hoặc server 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. Nếu bạn dùng nhà cung cấp AI đám mây, nội dung gửi để hỏi đáp sẽ đi qua nhà cung cấp đó. Mặc định ứng dụng không có mật khẩu, nên hãy giới hạn cổng về 127.0.0.1 hoặc đặt OPEN_NOTEBOOK_PASSWORD.

### Open Notebook khác gì Notebook LM của Google?

Theo bảng so sánh trong README: Open Notebook tự host, chọn được hơn 20 nhà cung cấp AI, podcast từ 1 đến 4 người nói, có REST API đầy đủ và mã nguồn mở. Notebook LM chạy trên đám mây của Google, chỉ dùng mô hình Google, podcast 2 người và không có API.

### Cần những API key nào?

Bạn cần key của ít nhất một nhà cung cấp AI, hoặc một máy chủ cục bộ như Ollama. Bạn nhập key trong giao diện web ở mục Models, không phải trong file cấu hình. Cần thêm một mô hình Language và một mô hình Embedding. Anthropic và Groq không có embedding nên cần ghép với nhà cung cấp khác.

### Giao diện có tiếng Việt không?

Danh sách ngôn ngữ giao diện trong README gồm tiếng Anh, Trung, Pháp, Đức, Nhật, Nga, Tây Ban Nha, Thổ Nhĩ Kỳ và vài thứ tiếng khác, nhưng không thấy tiếng Việt. Khả năng AI trả lời bằng tiếng Việt phụ thuộc mô hình bạn chọn, README không nói cụ thể.
