5 分钟跑通 Open Notebook：免费开源的本地 AI 笔记本完整上手指南
【免费下载链接】open-notebookAn Open Source implementation of Notebook LM with more flexibility and features项目地址: https://gitcode.com/GitHub_Trending/op/open-notebook
你是否也遇到过这种情况：调研资料散落在浏览器书签、PDF 和聊天记录里，想借助 AI 梳理，又不放心把资料上传给云端服务？Open Notebook 是一款可自托管的开源 AI 笔记本，帮你把多模型 AI 部署到本地完成资料整理与问答，是 Notebook LM 的开源平替。
🎯 一、它到底解决了什么问题
和 Notebook LM 这类云端服务相比，Open Notebook 有两个明显不同。第一，数据主权在你手里：所有源文件、笔记和对话都存放在你自己的数据库里，而不是服务商的服务器上。第二，模型由你选：它支持 18 家以上 AI 服务商，也可以接 Ollama 在本机跑开源模型，完全不用联网调用云端 API。
🚀 二、最短路径跑起来
前提只有一项：装好 Docker（Docker Desktop 即可）。
方式 A：容器化部署（最省事）
第 1 步：克隆仓库
git clone https://gitcode.com/GitHub_Trending/op/open-notebook cd open-notebook第 2 步：准备环境变量文件
cp .env.example .env.env用于本地部署的可选覆盖项，先照抄示例即可；API Key 不用写在这里，启动后在界面里配置。
第 3 步：改加密密钥
打开仓库根目录的docker-compose.yml，把OPEN_NOTEBOOK_ENCRYPTION_KEY=change-me-to-a-secret-string这一行的值改成你自己随便定的一段长字符串。它用来加密存在数据库里的 API Key，务必改掉默认值。
第 4 步：启动并打开界面
docker compose up -d等待 15~30 秒（首次要拉取镜像，稍慢），浏览器访问http://localhost:8502，看到界面即成功。
方式 B：全本地、免 API Key
想把模型也留在本机？把仓库里examples/目录下的docker-compose-ollama.yml复制到项目根目录并命名为docker-compose.yml，同样改掉加密密钥，再执行docker compose up -d。这套配置自带 Ollama 容器，配好后可完全离线运行。
启动后的第一个任务：进入Settings页面，选一个模型服务商，粘贴你的 Key（如YOUR_API_KEY），点Test Connection验证连通，再Discover Models把可用模型注册进来。
🖼️ 三、界面速览：从一个笔记本到一段对话
图 1：打开一个笔记本后的主工作区——左侧 Sources 栏添加网页链接或上传文档，中间 Notes 栏存放 AI 生成的摘要与洞察笔记，右侧 Chat 栏基于这些材料回答你的问题并标注来源引用
仓库内目前只提供这一张界面截图，其余环节你可以按下面的动线亲手走一遍：点击New Notebook创建笔记本 → 在 Sources 栏点Add Source丢入链接、PDF 或音频 → 等待内容被自动处理和摘要 → 在 Chat 栏提问，或进入Podcasts页把整份材料变成一段多人对话的播客。
🧩 四、核心模块拆解：每个功能在仓库哪里
- 笔记本管理：整个工作区围绕 Notebook 组织，把源、笔记、对话装进同一个项目里，前端代码见 frontend/src/app/(dashboard)/notebooks//notebooks/)
- 源管理：导入网页、PDF、音频、Office 文档等，系统自动完成解析、切片和摘要，前端入口见 frontend/src/components/sources/
- 上下文聊天：带多会话管理，回答基于你笔记本里的资料检索并附来源引用，后端对话逻辑见 open_notebook/graphs/
- 智能搜索：对全部内容做全文 + 向量两种检索，API 层见 api/routers/search.py
- 播客生成：把材料变成 1~4 个说话人的播客，支持自定义说话人档案，相关代码见 open_notebook/podcasts/
❓ 五、上手中的高频卡点
Q：需要提前准备什么？A：一台装了 Docker 的电脑，4GB 内存就够用。模型 API Key 可以之后再配，不阻塞启动。
Q：加密密钥和 API Key 分别在哪里填？A：OPEN_NOTEBOOK_ENCRYPTION_KEY写在docker-compose.yml里，用于数据库加密；模型 API Key 在 Settings 界面里添加，两者不要混。
Q：docker compose up -d后打不开 8502 端口？A：先docker compose ps确认数据库和应用两个容器都 running。首次启动拉镜像要几分钟，耐心等一等再看。
Q：完全没有云端 API Key 能用吗？A：能。选方式 B 的 Ollama 配置，在 Settings 里填http://ollama:11434作为地址即可全程离线运行。
Q：重启后数据会丢吗？A：不会。文档存在notebook_data/目录、数据库在surreal_data/目录，由容器挂载持久化，删掉容器也不影响数据。
克隆仓库、改一处密钥、启动后打开浏览器，Open Notebook 就在你电脑里跑起来了——现在就可以去试。
【免费下载链接】open-notebookAn Open Source implementation of Notebook LM with more flexibility and features项目地址: https://gitcode.com/GitHub_Trending/op/open-notebook
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
