Minimum Python Version Maximum Python Version Tested Supported Python Versions

This project has been tested and is compatible with Python versions 3.9, 3.10, and 3.11. While it might work on other versions, these are the officially supported and tested ones.

Getting Started#

Before you can run this project, you need to have python installed on your system

Option 1: Setting up a Python Virtual Enviroment (venv)#

This is the standard way to create an isolated Python enviroment.

Steps:

  1. Install pip (if you don’t have it):

 python -m ensurepip --default-pip

or on some systems:

 sudo apt update
 sudo apt install python3-pip
  1. Create a virtual enviroment:

   python -m venv venv

This command creatas a new directory named venv (you can choose a different name if you prefer) containing a copy of the Python interpreter and necessary supporting files.

  1. Activate the virtual enviroment:

  • On macOS and Linux:

  source venv/bin/activate
  • On Windows (command promt):

  venv\Scripts\activate
  • On Windows (PowerShell):

  .\venv\Scripts\Activate.ps1

Once the activated, you’ll see (venv) at the beginning of your terminal promt.

  1. Install project dependencies: Once the virtual enviroment is activated, you can install the required packages listed in the requirements.txt file:

pip install  .
  1. Deactivate the virtual enviroment (when you are done):

     deactivate
    

    This will return you to your base Python enviroment.

Option 2: Setting up a Conda Enviroment#

  1. Create the environment from the requirements.txt file. This can be done using anaconda, miniconda, miniforge, or any other environment manager.

conda create -n qbc python==3.11

  • Note: if you receive the error bash: conda: command not found..., you need to install some form of anaconda to your development environment.

  1. Activate the new environment:

conda activate qbc
pip install .
  1. Verify that the new environment and packages were installed correctly:

conda env list
pip list