安装详情#

本节提供关于安装 Bokeh 的更详细信息。这包括 Bokeh 的先决条件以及 Bokeh 的必需和可选依赖项的详细信息。

支持的平台#

Bokeh 官方支持（并持续测试）CPython 3.10 及更高版本。Bokeh 可能在其他 Python 版本上也能工作，但不提供任何保证或支持。

使用 conda 或 pip 安装#

可以使用 Python 包安装程序 pip 或 conda 安装 Bokeh，conda 是 Anaconda Python Distribution 的包管理器。

使用 pip 安装

使用以下命令安装 Bokeh

pip install bokeh

使用 conda 安装

确保您已安装 Anaconda 或 Miniconda。使用以下命令从默认通道安装 Bokeh

conda install bokeh

或者，如果您想确保在每次新发布后始终拥有最新版本的 Bokeh，请直接从 Bokeh 通道 安装

conda install -c bokeh bokeh

检查您的安装#

要验证安装是否成功，请使用以下命令

bokeh info

您应该看到，其中包括一行包含有关已安装 Bokeh 版本的信息。

如果您收到错误，请尝试使用 Stack Overflow 上的 “bokeh” 标签 搜索更多信息，或在 Bokeh Discourse 社区中提问。

提示

安装 Bokeh 后，按照入门指南构建您的第一个可视化。

查看用户指南，全面了解您可以使用 Bokeh 完成的所有操作。

为开发安装#

如果您想安装 Bokeh 的开发版本以贡献项目，请参阅 贡献者指南中的 设置开发环境 说明。

安装必需的依赖项#

对于基本用法，Bokeh 需要以下库

  • Jinja2 >=2.9
  • contourpy >=1.2
  • narwhals>=1.13
  • numpy >=1.16
  • packaging >=16.8
  • pandas >=1.2
  • pillow >=7.1.0
  • PyYAML >=3.10
  • tornado >=6.2; sys_platform != ‘emscripten’
  • xyzservices >=2021.09.1

如果您使用 conda 或 pip，则所有这些软件包都会自动安装。

安装可选依赖项#

除了必需的依赖项之外，某些可选功能还需要一些额外的软件包

Jupyter

Bokeh 可以在经典的 Jupyter notebook 以及 JupyterLab 中显示内容。根据您的设置，可能需要安装其他软件包或 Jupyter 扩展。有关完整详细信息，请参阅 Jupyter。

NodeJS

对于 自定义扩展 或在 TypeScript 中定义 CustomJS 实现是必需的。

NetworkX

要使用 from_networkx() 函数直接从 NetworkX 数据生成 Bokeh 图形渲染器，这是必需的。

psutil

要启用 Bokeh 服务器中的详细内存日志记录，这是必需的。

Selenium, GeckoDriver, Firefox

对于将 PNG 和 SVG 导出为 PNG 和 SVG 图像是必需的。

Sphinx

要使用 bokeh.sphinxext Sphinx 扩展在 Sphinx 文档中包含 Bokeh 绘图，这是必需的。

安装示例数据#

（可选）Bokeh 可以下载并安装示例数据集合。这包括您可以与 Bokeh 一起使用的各种免费数据表和数据库。由于此示例数据相当大，因此未包含在 Bokeh 的安装包中。

在 Bokeh 的 GitHub 存储库 中，您可以找到许多示例。这些示例也使用此示例数据。有关 Bokeh 示例数据中包含的数据集的更多信息，请参阅 bokeh.sampledata。

安装 Bokeh 后，您可以使用以下命令自动下载并安装示例数据

pip install bokeh_sampledata

安装独立的 BokehJS#

BokehJS 是 Bokeh 的客户端运行时库。您也可以将 BokehJS 用作独立的 JavaScript 库。为此，请从 Bokeh 的内容分发网络 (CDN) cdn.bokeh.org 下载代码。CDN 使用以下命名方案

# Javascript files
https://cdn.bokeh.org/bokeh/release/bokeh-x.y.z.min.js
https://cdn.bokeh.org/bokeh/release/bokeh-widgets-x.y.z.min.js
https://cdn.bokeh.org/bokeh/release/bokeh-tables-x.y.z.min.js
https://cdn.bokeh.org/bokeh/release/bokeh-api-x.y.z.min.js
https://cdn.bokeh.org/bokeh/release/bokeh-gl-x.y.z.min.js
https://cdn.bokeh.org/bokeh/release/bokeh-mathjax-x.y.z.min.js

始终只需要 Bokeh 核心库 bokeh-x.y.z.min.js。其他脚本是可选的，只有在您想使用相应功能时才需要包含。

  • 如果您正在使用任何 Bokeh 小部件，则只需要 "bokeh-widgets" 文件。

  • 如果您正在使用 Bokeh 的 数据表，则只需要 "bokeh-tables" 文件。

  • 要使用 BokehJS API，需要 "bokeh-api" 文件，并且必须在核心 BokehJS 库之后加载。

  • 要启用 WebGL 支持，需要 "bokeh-gl" 文件。

  • 要启用 MathJax 支持，需要 "bokeh-mathjax" 文件。

将 x.y.z 替换为您要使用的 Bokeh 版本。例如，版本 3.0.0 的链接是

注意

您应该始终在从 CDN 加载 BokehJS 的 script 标签上设置 crossorigin="anonymous"。