yolo_aqualite
Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.7%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: MuhabHariri
- License: agpl-3.0
- Language: Python
- Default Branch: main
- Size: 363 MB
Statistics
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 3
- Releases: 0
Metadata Files
docs/README.md
This repository accompanies the paper
"YOLO-AquaLite: A Lightweight Fish Detection Model for Real-Time Underwater Applications"
Setup, Configuration, and Training
This project is built on top of the Ultralytics YOLO framework, specifically YOLOv11.
For environment setup, dataset preparation, and general usage instructions, please refer to the official Ultralytics YOLO Documentation.
Installing YOLO-AquaLite
Prerequisite: Python must already be installed on your system.
Follow these steps to install YOLO-AquaLite in a clean virtual environment:
```bash
1. Create a virtual environment
python3 -m venv venv_aqualite
2. Activate the environment
source venv_aqualite/bin/activate
3. Change directory to the virtual environment:
cd venv_aqualite/
4. Install Ultralytics (tested with version 8.3.72)
python3 -m pip install ultralytics==8.3.72
5. Clone the YOLO-AquaLite repository
git clone https://github.com/MuhabHariri/YOLO_AquaLite.git
6. Change directory into the project folder
cd YOLO_AquaLite/
7. Install YOLO-AquaLite in editable mode
pip install -e .
```
What is YOLO_AquaLite?
YOLO_AquaLite is an object detection model based on the YOLOv11 architecture, designed with a focus on computational efficiency and lightweight deployment.
It introduces several architectural enhancements to optimize performance:
Replaces the initial backbone layers with a pre-trained encoder
Utilizes Dilated DeepResNet Blocks instead of traditional C3k2 blocks
Incorporates a Spatial-to-Channel Projection block into the pipeline
These improvements make YOLO_AquaLite significantly lighter than the original YOLOv11, with lower model size, reduced computational cost, and improved latency, while maintaining competitive detection accuracy.
Weight Files
Weights files (trained on COCO dataset):
The folderWeights files (trained on COCO dataset)includes YOLOAquaLite model variants ([nano](https://github.com/MuhabHariri/YOLO_AquaLite/raw/main/Weights%20files%20(trained%20on%20COCO%20dataset)/YOLOAquaLiteCOCOn.pt), small, medium, large, and xlarge) trained on the COCO dataset.Weights files (Fine-tuned on Fish dataset):
The folderWeights files (Fine_tuned on Fish dataset)contains YOLOAquaLite model variants ([nano](https://github.com/MuhabHariri/YOLOAquaLite/raw/main/Weights%20files%20(Finetuned%20on%20Fish%20dataset)/YOLOAquaLiten.pt), [small](https://github.com/MuhabHariri/YOLOAquaLite/raw/main/Weights%20files%20(Finetuned%20on%20Fish%20dataset)/YOLOAquaLites.pt), [medium](https://github.com/MuhabHariri/YOLOAquaLite/raw/main/Weights%20files%20(Finetuned%20on%20Fish%20dataset)/YOLOAquaLitem.pt), [large](https://github.com/MuhabHariri/YOLOAquaLite/raw/main/Weights%20files%20(Finetuned%20on%20Fish%20dataset)/YOLOAquaLitel.pt), and [xlarge](https://github.com/MuhabHariri/YOLOAquaLite/raw/main/Weights%20files%20(Finetuned%20on%20Fish%20dataset)/YOLOAquaLite_xl.pt)) that have been fine-tuned on the fish dataset described in our paper.
Training YOLO_AquaLite
To train a YOLO_AquaLite model variant, use the following command:
bash
yolo detect train data=Dataset.yaml model=ultralytics/cfg/models/11/YOLO_AquaLite_Variant.yaml epochs=500 batch=32 imgsz=640
Replace Variant with the desired model size: n (nano), s (small), m (medium), l (large), or xl (xlarge).
Owner
- Name: Muhab Hariri
- Login: MuhabHariri
- Kind: user
- Location: Turkey
- Website: https://www.linkedin.com/in/muhab-hariri/
- Repositories: 1
- Profile: https://github.com/MuhabHariri
GitHub Events
Total
- Delete event: 2
- Issue comment event: 9
- Push event: 9
- Pull request event: 8
- Fork event: 1
- Create event: 15
Last Year
- Delete event: 2
- Issue comment event: 9
- Push event: 9
- Pull request event: 8
- Fork event: 1
- Create event: 15
Dependencies
- actions/checkout v4 composite
- actions/setup-python v5 composite
- astral-sh/setup-uv v5 composite
- codecov/codecov-action v5 composite
- conda-incubator/setup-miniconda v3 composite
- slackapi/slack-github-action v2.0.0 composite
- ultralytics/actions/cleanup-disk main composite
- contributor-assistant/github-action v2.6.1 composite
- actions/checkout v4 composite
- docker/login-action v3 composite
- docker/setup-buildx-action v3 composite
- docker/setup-qemu-action v3 composite
- slackapi/slack-github-action v2.0.0 composite
- ultralytics/actions/cleanup-disk main composite
- ultralytics/actions/retry main composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- astral-sh/setup-uv v5 composite
- ultralytics/actions main composite
- actions/checkout v4 composite
- ultralytics/actions/retry main composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- actions/checkout v4 composite
- actions/download-artifact v4 composite
- actions/setup-python v5 composite
- actions/upload-artifact v4 composite
- astral-sh/setup-uv v5 composite
- pypa/gh-action-pypi-publish release/v1 composite
- slackapi/slack-github-action v2.0.0 composite
- actions/stale v9 composite
- pytorch/pytorch 2.5.1-cuda12.4-cudnn9-runtime build
- matplotlib >=3.3.0
- numpy >=1.23.0,<=2.1.1
- opencv-python >=4.6.0
- pandas >=1.1.4
- pillow >=7.1.2
- psutil *
- py-cpuinfo *
- pyyaml >=5.3.1
- requests >=2.23.0
- scipy >=1.4.1
- seaborn >=0.11.0
- torch >=1.8.0
- torch >=1.8.0,!=2.4.0; sys_platform == 'win32'
- torchvision >=0.9.0
- tqdm >=4.64.0
- ultralytics-thop >=2.0.0