安装详情#

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

支持的平台#

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

使用 conda 或 pip 安装#

Bokeh 可以使用 Python 包安装器 pip 或 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
  • 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 的安装包中。

在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 widgets时，才需要"bokeh-widgets"文件。

  • "bokeh-tables" 文件仅在您使用 Bokeh 的 数据表 时才需要。

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

  • "bokeh-gl" 文件是启用 WebGL支持所必需的。

  • 需要"bokeh-mathjax"文件来启用 MathJax support。

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

注意

你应该总是在从CDN加载BokehJS的脚本标签上设置crossorigin="anonymous"。