# Installation

## Requirements

You can install bbbdl on any computer with the following software already installed:

- Python 3.11+

- ffmpeg

## Installing bbbdl

bbbdl is distributed through PyPI, the Python Package Index.

### Using pipx

The easiest way to install bbbdl, but requires pipx to be installed separately.

Run the following command in a terminal or command prompt:

    pipx install bbbdl

This will install bbbdl for the current user in an isolated environment so that the dependencies don’t conflict with other software already on your system.

### Using pip and venv

If pipx is not available, you can manually install bbbdl in a virtual environment (venv).

First, create a venv:

    python -m venv venv

Then, enter the venv:

    # Assuming you're using Linux and bash
    source venv/bin/activate

While inside the venv, install bbbdl with pip:

    pip install bbbdl

Done! Remember that, if you install bbbdl using this method, you’ll need to have entered the venv in that terminal session to use bbbdl!