Skip to content

MacMat01/yolo-card-trainer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cards Object Detection

CodeQL

This project aims to detect strategic fruits cards using YOLOv8. It is implemented in Python and uses several libraries for data processing and model training.

Project Structure

The project has the following structure:

  • src/: Contains the source code of the project.
    • dataset_creation/: Contains the scripts for creating the dataset.
    • model_training/: Contains the scripts for training the YOLOv8 model.
  • environment.yml: Contains the conda environment configuration.
  • setup.py: Contains the setup configuration for the Python package.

Getting Started

Prerequisites

Ensure you have the following installed on your system:

Installation

  1. Clone the repository:
git clone https://github.com/MacMat01/yolo-card-trainer.git
  1. Navigate to the project directory:
cd yolo-card-trainer
  1. Create a new conda environment from the environment.yml file:
conda env create --name <your-environment-name> -f environment.yml
  1. Activate the conda environment:
conda activate <your-environment-name>
  1. Install the build and pip tools:
pip install --upgrade build pip
  1. Build a source distribution (sdist) and a binary distribution (wheel) of your package:
python -m build
  1. Install the package from the wheel file:
pip install --user dist/*.whl # If it doesn't work, change </*.whl> to the name of the wheel file generated in step 6
  1. (OPTIONAL) If gpu isn't working for model training, install pytorch-cuda manually (remember to restart pc, it often works):
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia

Running the Application

Follow the instruction in the following Jupyter notebooks:

  1. Cards Extraction.ipynb
  2. Dataset Creation.ipynb
  3. YOLO Card Trainer.ipynb

License

This project is licensed under the MIT License—see the LICENSE file for details.

About

This project's aim is to guide through the process of creating a dataset, and then training an object detection model to detect cards in real time

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors