jupyterlab

安装|文档|贡献|许可证|团队|获得帮助|

Jupyter实验室

基于 Jupyter Notebook 和架构的交互式和可重复计算的可扩展环境。

JupyterLab 是 Jupyter 项目的下一代用户界面，在灵活而强大的用户界面中提供经典 Jupyter Notebook 的所有熟悉的构建块（笔记本、终端、文本编辑器、文件浏览器、丰富的输出等）。

JupyterLab 可以使用使用我们公共 API 的 npm 包进行扩展。预构建的扩展可以通过 PyPI、conda 和其他包管理器分发。源扩展可以直接从 npm 安装（搜索 jupyterlab-extension），但需要额外的构建步骤。您还可以通过探索 GitHub 主题 jupyterlab-extension 找到 JupyterLab 扩展。要了解有关扩展的更多信息，请参阅用户文档。

阅读 ReadTheDocs 上的最新 JupyterLab 文档。

重要的

JupyterLab 3 于 2024 年 5 月 15 日达到维护结束日期。关键问题的修复仍将向后移植，直到 2024 年 12 月 31 日。如果您仍在运行 JupyterLab 3，我们强烈建议您尽快升级到 JupyterLab 4。有关更多信息，请参阅 Jupyter 博客上的 JupyterLab 3 维护结束。

---

入门

安装

如果您使用 conda、mamba 或 pip，则可以使用以下命令之一安装 JupyterLab。

• 如果您使用康达：

  conda install -c conda-forge jupyterlab

• 如果你使用曼巴：

  mamba install -c conda-forge jupyterlab

• 如果您使用点：

  pip install jupyterlab

  如果使用pip install --user安装，则必须将用户级bin目录添加到PATH环境变量中才能启动jupyter lab 。如果您使用的是 Unix 衍生版本（例如 FreeBSD、GNU/Linux、macOS），您可以通过运行export PATH="$HOME/.local/bin:$PATH"来执行此操作。

有关更详细的说明，请参阅安装指南。贡献者文档中提供了来自 git 源的项目安装说明。

使用旧版本的 Jupyter Notebook 进行安装

当使用 5.3 之前的 Jupyter Notebook 版本时，安装 JupyterLab 后必须运行以下命令以启用 JupyterLab 服务器扩展：

jupyter serverextension enable --py jupyterlab --sys-prefix

跑步

使用以下命令启动 JupyterLab：

jupyter lab

JupyterLab 将在浏览器中自动打开。有关更多详细信息，请参阅文档。

如果遇到类似“Command 'jupyter' not find”的错误，请确保PATH环境变量设置正确。或者，您可以使用~/.local/bin/jupyter lab启动 JupyterLab，而无需更改PATH环境变量。

先决条件和支持的浏览器

目前已知以下浏览器的最新版本可以运行：

• 火狐浏览器
• 铬合金
• 狩猎之旅

请参阅我们的文档了解更多详细信息。

---

寻求帮助

我们鼓励您在 Discourse 论坛上提问。在那里回答的问题可以成为对其他人有用的资源。

错误报告

要报告错误，请阅读指南，然后打开 Github 问题。为了保持已解决的问题独立，锁定机器人将在一段时间不活动后将已解决的已关闭问题锁定为已解决。如果问题锁定后仍需要相关讨论，请开新问题并引用旧问题。

功能请求

我们也欢迎对新功能提出建议，因为它们有助于使该项目对每个人都更有用。要请求功能，请使用功能请求模板。

---

发展

扩展 JupyterLab

要开始开发 JupyterLab 扩展，请参阅开发人员文档和 API 文档。

贡献

要向 JupyterLab 本身贡献代码或文档，请阅读贡献者文档。

JupyterLab 遵循 Jupyter 社区指南。

执照

JupyterLab 使用共享版权模型，使所有贡献者都能维护其贡献的版权。所有代码均根据修订后的 BSD 许可证条款获得许可。

团队

JupyterLab 是 Jupyter 项目的一部分，由开放社区开发。维护团队得到了 JupyterLab 和整个 Jupyter 项目的更多贡献者的协助。

JupyterLab 当前的维护者按字母顺序列出，并附有从属关系和主要贡献领域：

• Mehmet Bektas，Netflix（一般开发、扩展）。
• Alex Bozarth，IBM（一般开发、扩展）。
• Eric Charles，Datalayer（一般开发、扩展）。
• Frédéric Collonval，WebScIT（一般开发、扩展）。
• Martha Cryan，Mito（一般开发、扩展）。
• Afshin Darian，QuantStack（共同创建者，应用程序/高级架构，在整个代码库中做出了大量贡献）。
• Vidar T. Fauske，摩根大通（一般开发、扩展）。
• Brian Granger，AWS（联合创始人，战略、愿景、管理、UI/UX 设计、架构）。
• Jason Grout，Databricks（联合创始人、愿景、总体开发）。
• Michał Krassowski，Quansight（一般开发、扩展）。
• Max Klein，摩根大通（UI 包、构建系统、一般开发、扩展）。
• Gonzalo Peña-Castellanos，QuanSight（一般开发、i18n、扩展）。
• Fernando Perez，加州大学伯克利分校（愿景联合创始人）。
• Isabela Presedo-Floyd，QuanSight 实验室（设计/用户体验）。
• Steven Silvester，MongoDB（共同创建者，发布管理，打包，整个代码库的多产贡献）。
• Jeremy Tuloup，QuantStack（一般开发、扩展）。

名誉维护者：

• Chris Colbert，Jupyter 项目（联合创建者、应用程序/底层架构、技术领导力、愿景、PhosphorJS）
• Jessica Forde，Jupyter 项目（演示、文档）
• Tim George，加州理工大学（UI/UX 设计、策略、管理、用户需求分析）。
• Cameron Oelsen，加州理工学院（UI/UX 设计）。
• Ian Rose，Quansight/洛杉矶市（一般核心开发、扩展）。
• Andrew Schlaepfer，彭博社（一般开发、扩展）。
• Saul Shanabrook，Quansight（总体开发、扩展）

提供此列表是为了让读者了解我们是谁以及我们的团队如何运作。要列出，请提交包含您的信息的拉取请求。

---

每周开发会议

我们每周都会举行视频会议，讨论我们一直在做的事情并互相获取反馈。

如果任何人想讨论某个话题或只是倾听，欢迎任何人参加。

• 时间：太平洋时间周三上午 9:00（美国）
• 其中： jovyan Zoom
• 内容：会议记录

注释存档在 GitHub Jupyter Frontends team compass 上。