Bokeh Environment Setup: Install and Configure Bokeh for Python Development

Before you can create interactive charts and dashboards with Bokeh, you need a properly configured Python environment. Fortunately, setting up Bokeh is straightforward and only takes a few minutes. Once installed, you'll be ready to build interactive visualizations that run directly in your web browser or inside Jupyter Notebook.

This guide walks you through the complete Bokeh environment setup, including installing Python, creating a virtual environment, installing Bokeh, verifying the installation, and preparing optional tools for a smooth development experience.

Prerequisites

Before installing Bokeh, make sure your computer has:

• Python 3.9 or later (recommended)
• pip (Python package manager)
• A code editor such as Visual Studio Code or PyCharm
• Terminal or Command Prompt access
• An internet connection to download packages

To verify your Python installation, open a terminal or command prompt and run:

python --version

If your system uses the python3 command instead, run:

python3 --version

You should see your installed Python version displayed.

Install Python

If Python is not installed, download the latest stable release from the official Python website.

During installation on Windows:

• Check Add Python to PATH
• Select Install Now
• Allow the installer to complete

After installation, restart your terminal and verify the installation again.

Create a Virtual Environment (Recommended)

Using a virtual environment keeps project dependencies isolated and prevents conflicts between different Python projects.

Create a new virtual environment:

python -m venv bokeh_env

Activate the environment.

Windows

bokeh_env\Scripts\activate

macOS and Linux

source bokeh_env/bin/activate

Once activated, your terminal prompt will typically display the environment name.

Install Bokeh

Install Bokeh using pip:

pip install bokeh

To install a specific version:

pip install bokeh==3.7.3

Replace the version number with the release required for your project if necessary.

Install Common Data Science Libraries

Bokeh works especially well with several popular Python libraries. Installing them now can simplify future projects.

pip install pandas numpy matplotlib jupyter

These packages provide:

• Pandas for data manipulation
• NumPy for numerical computing
• Matplotlib for static visualizations
• Jupyter Notebook for interactive development

Verify the Installation

To confirm that Bokeh is installed correctly, start the Python interpreter:

python

Then run:

import bokeh
print(bokeh.__version__)

If no errors appear and a version number is printed, your installation is successful.

Exit the interpreter:

exit()

Create Your First Test Script

Create a file named test_bokeh.py.

Add the following code:

from bokeh.plotting import figure, show

x = [1, 2, 3, 4, 5]
y = [3, 7, 4, 8, 5]

plot = figure(title="Bokeh Installation Test")

plot.line(x, y, line_width=3)

show(plot)

Save the file and run:

python test_bokeh.py

A web browser should open and display an interactive line chart, confirming that your environment is working correctly.

Using Bokeh with Jupyter Notebook

Bokeh integrates seamlessly with Jupyter Notebook.

Launch Jupyter:

jupyter notebook

In your notebook, initialize Bokeh output:

from bokeh.io import output_notebook
output_notebook()

You can now display interactive visualizations directly inside notebook cells.

Using Visual Studio Code

Visual Studio Code is one of the most popular editors for Python development.

Recommended extensions include:

• Python
• Jupyter
• Pylance

After opening your project folder:

• Select the correct Python interpreter.
• Activate your virtual environment.
• Install project dependencies if needed.
• Run your Bokeh scripts using the integrated terminal.

Keeping Bokeh Updated

To upgrade to the latest version:

pip install --upgrade bokeh

Check the installed version again:

pip show bokeh

Common Installation Issues

Python Not Found

If you receive a "Python is not recognized" error:

• Ensure Python is installed.
• Add Python to your system PATH.
• Restart your terminal.

pip Not Recognized

Try:

python -m pip install bokeh

This uses Python's built-in package manager directly.

Virtual Environment Not Activating

Verify that:

• The environment was created successfully.
• You're using the correct activation command for your operating system.
• Your terminal has permission to execute activation scripts.

Import Errors

If import bokeh fails:

• Confirm Bokeh is installed in the active environment.
• Ensure your IDE is using the same Python interpreter as your terminal.
• Reinstall the package if necessary.

Best Practices

To maintain a clean and reliable development setup:

• Use a separate virtual environment for each project.
• Keep Python and Bokeh updated.
• Install only the packages your project requires.
• Document dependencies using a requirements.txt file.
• Test your environment after installing new packages.

Following these practices helps ensure consistent results across different systems and simplifies collaboration with other developers.

Conclusion

Setting up the Bokeh environment is a simple process that prepares you to build powerful, interactive visualizations with Python. By installing Python, creating a virtual environment, adding Bokeh and supporting libraries, and verifying the installation, you'll have a solid foundation for developing charts, dashboards, and data-driven web applications.

With your environment ready, the next step is to explore Bokeh's plotting tools, customization options, interactive widgets, and dashboard capabilities to create engaging visual experiences for your users.