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
Last synced: 10 months ago · JSON representation

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
Created about 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme Contributing License Citation

docs/README.md

This repository accompanies the paper
"YOLO-AquaLite: A Lightweight Fish Detection Model for Real-Time Underwater Applications"


Setup, Configuration, and Training

Ultralytics logo

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 folder Weights 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 folder Weights 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

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

.github/workflows/ci.yml actions
  • 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
.github/workflows/cla.yml actions
  • contributor-assistant/github-action v2.6.1 composite
.github/workflows/docker.yml actions
  • 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
.github/workflows/docs.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • astral-sh/setup-uv v5 composite
.github/workflows/format.yml actions
  • ultralytics/actions main composite
.github/workflows/links.yml actions
  • actions/checkout v4 composite
  • ultralytics/actions/retry main composite
.github/workflows/merge-main-into-prs.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
.github/workflows/publish.yml actions
  • 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
.github/workflows/stale.yml actions
  • actions/stale v9 composite
examples/YOLO-Series-ONNXRuntime-Rust/Cargo.toml cargo
examples/YOLOv8-ONNXRuntime-Rust/Cargo.toml cargo
docker/Dockerfile docker
  • pytorch/pytorch 2.5.1-cuda12.4-cudnn9-runtime build
pyproject.toml pypi
  • 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