.. _installation:

*******************************************************************************
Installation
*******************************************************************************

============
Requirements
============

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

* `Python 3.11+ <https://www.python.org/>`_
* `ffmpeg <https://ffmpeg.org/download.html>`_

================
Installing bbbdl
================

bbbdl is distributed through `PyPI, the Python Package Index <https://pypi.org/project/bbbdl/>`_.


Using pipx
----------

The easiest way to install bbbdl, but requires `pipx <https://pipxproject.github.io/pipx/installation/>`_ to be
installed separately.

Run the following command in a terminal or command prompt:

.. code-block:: bash

   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:

.. code-block:: bash

   python -m venv venv

Then, enter the venv:

.. code-block:: bash

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

While inside the venv, install bbbdl with pip:

.. code-block:: bash

   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!