2 ‐ Requirements - Af-Oliveira/WasteVision GitHub Wiki

Installation and Dependency Setup

1. Clone Ultralytics (YOLO) into third_party

You must clone the official Ultralytics repository into the third_party folder:

git clone https://github.com/ultralytics/ultralytics.git

2. Activate the Virtual Environment

Use the generated activation script to activate your desired environment:

  • On Windows:
    activate_env.bat
    
  • On Linux/Mac:
    source activate_env.sh
    

You will be presented with a menu to select which environment to activate (e.g., YOLOv8).

Note: Each environment is configured to automatically launch a main.py file inside its respective models folder upon activation. This is defined in the project's config.json and handled by a post_activate.bat or post_activate script.

3. Use the Main Menu to Install Requirements

After activation, you will see the environment's main menu. To install the required dependencies for Ultralytics:

  1. Choose the "Install Requirements" option in the menu.
  2. Select any extras you need (such as export, dev, etc.) when prompted.
  3. The script will install the requirements from the ultralytics/pyproject.toml file.
  4. When installation is complete, exit the main menu. You will then be dropped into the environment's command prompt.

4. Install Ultralytics in the Environment

At the environment prompt, run:

pip install ultralytics

This ensures the ultralytics package is available in your environment for training, inference, and export.

5. Notes

  • The activation menu and post-activation scripts (post_activate.bat or post_activate) are automatically generated and handle launching the main menu for each environment.
  • You can always re-run the activation script to switch environments or re-enter the main menu.
  • All environment and menu logic is defined in the config.json file and managed by the setup scripts.