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 里,数据还放在别人家服务器上,你说了不算。Open Notebook 是一款可私有部署的开源 AI 研究笔记本:把文档、网页、音视频喂进去,它帮你基于自己的资料做 AI 对话、生成笔记、导出播客。本文带你三步跑起来,然后走一遍界面和几个核心功能。
三步启动 Open Notebook 并打开笔记本界面
前置条件只有一项:机器上装好 Docker(一种把应用打包在容器里运行的工具)。AI 的 API key 后面在界面里配就行。
第一步,克隆部署文件到本地:
git clone https://gitcode.com/GitHub_Trending/op/open-notebook cd open-notebook第二步,打开根目录的docker-compose.yml,把OPEN_NOTEBOOK_ENCRYPTION_KEY的默认值改成你自己的一串秘密字符串,它用来加密保存在数据库里的 API key。
第三步,启动服务:
docker compose up -d这条命令会拉取镜像并后台启动两个容器:一个是 Open Notebook 本体,一个是 SurrealDB(存你笔记本数据的数据库)。等 15~20 秒,浏览器打开http://localhost:8502,你会看到带笔记本列表的主界面。
启动后看到的主界面:左侧是笔记本列表,点进去就是三栏研究工作区
界面能用了,接下来配 AI。顶部导航进Settings → API Keys → Add Credential,选一家提供商(OpenAI、Anthropic、Ollama 等 18 家都支持),粘贴 API key(在对应厂商官网创建的密钥),点Test Connection确认连通,再点Discover Models同步模型列表。最后在Models页面给语言模型、嵌入模型、语音合成各选一个默认模型。
熟悉三栏界面:来源管理、笔记编辑、AI 对话
这节帮你把界面认全。
进任意笔记本后,屏幕分成三栏,顶部导航有 Notebooks、Search、Podcasts、Models、Settings 五个入口:
- 左栏 Sources(来源):你的原始资料。点Add Source可以传文件、贴网页链接、粘纯文本。每张来源卡片上有个上下文指示灯:绿表示 AI 能读全文,黄表示只能读摘要,关闭则完全不给 AI 看。
- 中栏 Notes(笔记):你的沉淀区。手动写的笔记和 AI 生成的笔记都存在这里,支持 Markdown。
- 右栏 Chat(对话):AI 对话区,底部有上下文计数器,显示当前对话包含哪些来源、大约多少 token。满意的答案可以一键存成笔记,还能按会话(Session)管理多轮话题。
每块区域具体长什么样,docs/3-USER-GUIDE/interface-overview.md 里有逐栏的图解,卡住了可以先对照它。
功能怎么用:从加资料到出播客
添加来源并和资料对话,拿到带引用的答案
操作:笔记本里点Add Source,选 Web Link 或 Upload File,粘贴链接或选一个 PDF,等 30~60 秒处理完成。
结果:左栏多出一张来源卡片。系统已经自动做了三件事:提取文字、把长文切成约 500 词的小块、给每块生成嵌入(把文字转成向量,让语义搜索成为可能)。这时在右栏问"这篇文档的核心观点是什么",AI 会基于这份资料回答并标注引用;回答不错,点保存就变成中栏的一条笔记。PDF、Word、PPT、MP3/MP4、YouTube 链接都支持,完整清单见 docs/3-USER-GUIDE/adding-sources.md。
全文检索和向量搜索,两种模式找内容
操作:进 Search 页面输入关键词,在 Text 和 Vector 之间切换,可以选择只在来源里搜还是只在笔记里搜。
结果:文本搜索按关键词即时命中原文,适合你记得确切用词的时候;向量搜索按语义找相关内容,搜"注意力机制"也能翻出讲"聚焦"的段落,适合模糊回忆。同一个问题两种模式各跑一遍,往往比只用一种找得更全。
生成多说话人播客,把研究变成可听的音频
操作:在笔记本里切到 Podcasts 标签,先建说话人档案(1~4 个,给每个人设角色、性格、语气和语音模型),再建一个 Episode Profile 定主题和风格,勾选要参与的来源和笔记,点 Generate。
结果:播客在后台异步生成,完成后可以在 Podcasts 页面播放和下载。通勤、跑步的时候听自己研究的资料,这是这个功能最典型的用法。
场景自查清单:你把这个研究笔记本用对了吗
- 一个研究项目一个笔记本,名字起得能一眼认出
- 对话前看过来源的上下文指示灯,绿(全文)、黄(仅摘要)分得清楚
- 至少把一条满意的 AI 回答存成了笔记
- 文本搜索和向量搜索都实际用过一次
notebook_data和surreal_data两个目录定期备份过(它们就是全部数据)
Open Notebook 把资料、笔记、对话全部留在你自己的服务器上,这就是私有部署的全部含义:AI 模型你选,数据你管,代码你也能改。下一步建议通读 docs/3-USER-GUIDE/index.md 里的内容转换和上下文控制章节;想动手改 AI 对话逻辑的话,从 open_notebook/graphs/ 开始看。
【免费下载链接】open-notebookAn Open Source implementation of Notebook LM with more flexibility and features项目地址: https://gitcode.com/GitHub_Trending/op/open-notebook
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考