To run the Fedora Artifact Downloader, you should set up a Python virtual environment. This ensures that the dependencies required by the project do not interfere with other Python projects or system-wide packages.

1. Ensure you have Python installed on your system. Python 3.6 or higher is required.

2. Create a virtual environment:

   python -m venv .venv

3. Activate the virtual environment:

   source .venv/bin/activate

4. Your command prompt should now reflect that you are working inside the 'venv' environment.

With the virtual environment activated, install the project dependencies by running:

pip install -r requirements.txt

To run the Fedora Artifact Downloader, use the following command:

python download_artifacts.py <version> [--output-dir <path>] [--mini] [--workers <num>] [--branched]

• <version>: The version of Fedora artifacts to download (e.g., 34, 35, rawhide).
• --output-dir <path>: (Optional) The directory where artifacts will be downloaded and extracted. Defaults to the current directory.
• --mini: (Optional) If set, only the minimal base artifact will be downloaded.
• --workers <num>: (Optional) Number of worker threads for downloading. Defaults to 5.
• --branched: (Optional) If set, use 'branched' in the URL instead of the version number.

For example, to download Fedora 35 artifacts to a specific directory with 10 worker threads, you would run:

python download_artifacts.py 35 --output-dir /path/to/output --workers 10

To download using the 'branched' URL, you would run:

```bash
python download_artifacts.py 35 --output-dir /path/to/output --workers 10 --branched

To deactivate the virtual environment when you're done, simply run:

deactivate