Installation

Python Packages (Required)

Create a fresh Python environment to isolate this project's dependencies:

cd /path/to/data-visualization-demo
python -m venv .venv

Activate the virtual environment:

With the virtual environment activated, install all required Python packages:

pip install -r requirements.txt

This installs ~75 packages including:

Depending on which features you want to use, you may need to install additional system-level packages.

Required for jupyter nbconvert --to pdf.

Debian/Ubuntu:

sudo apt update
sudo apt install -y texlive-xetex texlive-fonts-recommended texlive-latex-recommended

macOS (with Homebrew):

brew install mactex

Windows: Download and install MiKTeX or TeX Live from their official sites.

Alternative to LaTeX; recommended for environments where TeX is difficult to install.

Debian/Ubuntu:

sudo apt update
sudo apt install -y chromium-browser

macOS (with Homebrew):

brew install chromium

Windows: Download from Google Chrome or Chromium.

Debian/Ubuntu:

sudo apt install -y ffmpeg

macOS (with Homebrew):

brew install ffmpeg

Windows: Download from ffmpeg.org or install via Chocolatey:

choco install ffmpeg

To verify your installation, activate your virtual environment and run:

python -c "import jupyter, matplotlib, seaborn, plotly; print('All core packages imported successfully!')"
jupyter --version

You should see version information for Jupyter and no errors.

Once installed, see Running the Notebook to get started.