
jupyter-ai
在 JupyterLab 里直接对话,让 AI 帮你写代码、改报错、读数据
jupyter-ai 是 JupyterLab 官方生态下的开源扩展,把 AI 智能体直接接入计算笔记本。它解决数据科学和科研工作流中频繁在浏览器、聊天窗口和代码编辑器之间切换的问题:用户无需离开 JupyterLab,就能用自然语言生成代码、解释报错、补全单元格、总结 Notebook 内容,并让 AI 代理读取当前内核状态与变量。核心能力包括内联聊天面板、单元格级代码生成与修改、基于当前 Notebook 上下文的问答、可配置多家大模型后端,以及通过代理机制执行多步任务。项目用 Python 编写,以 JupyterLab 扩展形式分发,安装后即可在界面中使用,适合数据分析、机器学习实验和教学场景,让 AI 成为笔记本里的常驻助手而非外部工具。
项目数据
使用教程
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 已安装 JupyterLab(Jupyter AI 以 JupyterLab 扩展形式分发,需在 JupyterLab 中使用)
- 可用的 Python 环境(项目用 Python 编写)
- 至少安装一个受支持的 AI Agent 及其依赖(如 Claude、Codex、GitHub Copilot、Gemini、Goose、Kiro、Mistral
- 能访问所选用 Agent 的模型服务与网络
安装与启动步骤
-
1确认 JupyterLab 环境
Jupyter AI 是 JupyterLab 生态下的扩展,需先具备可用的 JupyterLab 环境再安装本扩展。
-
2安装 Jupyter AI 扩展
按项目仓库 README 提供的安装方式安装 Jupyter AI 扩展,安装后在 JupyterLab 中获得原生聊天界面。
-
3安装所选 AI Agent
安装你打算使用的 Agent(Claude、Gemini、Goose 等)及其依赖,Jupyter AI 会自动检测已安装的 Agent。
-
4启动并打开聊天面板
启动 JupyterLab,在界面中打开 Jupyter AI 的原生聊天面板,即可与检测到的 Agent 协作。
如何确认成功
启动 JupyterLab 后,界面中出现 Jupyter AI 的原生聊天面板,且已安装的 Agent 被自动检测到并可开始对话。
常见问题
Q:Jupyter AI 支持哪些 AI Agent?
A:支持 Claude、Codex、GitHub Copilot、Gemini、Goose、Kiro、Mistral Vibe、OpenCode 等,统一通过 Agent Client Protocol (ACP) 集成,安装依赖后会被自动检测。
Q:Agent 会不会擅自改我的文件或执行命令?
A:不会。Jupyter AI 带权限系统,Agent 在写入文件或执行终端命令前会先请求你的授权,相当于给你的操作加上护栏。
Q:可以接入自己领域的工具吗?
A:可以。你能添加自定义 MCP 服务器,为 Agent 提供特定领域的工具、资源和提示词;开发者还可用 entry points API 注册自己的 AI 人设。
Q:能同时开多个对话吗?
A:可以。Jupyter AI 支持创建多个并发聊天,并可拖拽文件或 Notebook 单元格作为上下文,还能与连接同一服务器的其他用户实时协作。
注意事项
- 本 README 节选未给出具体安装命令,实际安装方式请以项目仓库 README(https://github.com/jupyterlab/jupyter-ai)为准。
- Agent 只有在其依赖安装完成后才会被自动检测到,因此需要先装好 Jupyter AI 和你想用的 Agent。
- Agent 可通过内置 Jupyter MCP server 读写文件、执行终端命令并与 Notebook 交互,操作前会请求授权。
- 项目基于 ACP、MCP 等开放标准构建,便于替换或新增 Agent 与工具。
核心亮点
- 与 JupyterLab 深度集成,AI 能读取当前 Notebook 上下文和内核变量,回答和生成代码更贴合实际运行环境
- 支持多种大模型后端和自定义代理配置,用户可按需切换模型或接入私有部署
- 提供内联聊天、单元格生成、错误解释等多种交互方式,覆盖数据科学常见操作路径
不足之处
- 依赖 JupyterLab 版本和前端扩展生态,环境升级时可能出现兼容性问题
- AI 生成代码仍需人工审查,复杂任务下代理执行可能产生意外副作用
适用场景
- 数据分析师在 Notebook 中让 AI 根据 DataFrame 结构直接生成清洗和可视化代码
- 机器学习工程师遇到报错时,用聊天面板解释堆栈并给出修复建议
- 教师或学生用自然语言生成教学示例代码,降低 Jupyter 上手门槛
替代项目
jupyterlab-git、papermill
项目介绍
同类项目推荐
bolt.new
开源
想到啥说啥,网页应用当场生成直接能用
Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···
fuzz4all
开源
用大模型自动生成测试输入,发现各种软件漏洞
️Fuzz4All: Universal Fuzzing with Large Language Models
superpowers-zh
开源
全套 AI 编程神技汉化好了,照着用就行。
AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···
Gitea 代码托管
开源
轻量 Git 代码托管平台
Git with a cup of tea! Painless self-hosted all-in-one software development service,···