安装详情#

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

支持的平台#

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

使用 conda 或 pip 安装#

Bokeh 可以使用 Python 包安装程序 pip 或 conda（Anaconda Python 发行版 的包管理器）安装。

使用 pip 安装

使用此命令安装 Bokeh

pip install bokeh

使用 conda 安装

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

conda install bokeh

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

conda install -c bokeh bokeh

检查您的安装#

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

bokeh info

您应该看到，除其他内容外，一行包含有关已安装的 Bokeh 版本的信息。

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

提示

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

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

安装用于开发的 Bokeh#

如果您想安装用于开发的 Bokeh 版本以贡献项目，请参阅 设置开发环境 指令，这些指令位于 贡献者指南 中。

安装必需的依赖项#

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

  • Jinja2 >=2.9
  • contourpy >=1.2
  • numpy >=1.16
  • packaging >=16.8
  • pandas >=1.2
  • pillow >=7.1.0
  • PyYAML >=3.10
  • tornado >=6.2
  • xyzservices >=2021.09.1

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

安装可选依赖项#

除了必需的依赖项之外，某些其他包对于某些可选功能是必需的

Jupyter

Bokeh 可以将内容显示在经典的 Jupyter 笔记本以及 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 的 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 的脚本标签上设置 crossorigin="anonymous"。