CoralNet-Toolbox
CoralNet-Toolbox 🪸🧰
AI-Powered Annotation for Coral Reef Analysis
An unofficial toolkit to supercharge your CoralNet workflows.
⚡ Get Started
1. Create Environment (Recommended)
conda create --name coralnet10 python=3.10 -y
conda activate coralnet10
2. Install
# Use UV for the fastest installation
pip install uv
uv pip install coralnet-toolbox
# Or use standard pip
pip install coralnet-toolbox
3. Launch
coralnet-toolbox
4. (Optional) GPU Acceleration For full acceleration, install PyTorch with CUDA support.
# Example for CUDA 12.9
uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu129
See the Installation Guide for details on other versions.
Fallback: If UV fails, use regular pip:
pip install coralnet-toolbox
🎯 GPU Status Indicators
- 🐢 CPU only
- 🐇 Single GPU
- 🚀 Multiple GPUs
- 🍎 Mac Metal (Apple Silicon)
Click the icon in the bottom-left to see available devices
🔄 Upgrading
# When updates are available
uv pip install -U coralnet-toolbox==[latest_version]
📚 Resources & Advanced Details
- Installation Guide: Detailed setup for CUDA, Windows, and Mac.
- User Manual: A complete guide to all tools and features.
- Hot Keys: Keyboard shortcuts to accelerate your workflow.
- AI Tutorial: Learn to train your own classification models.
📺 Watch the Demo Videos
🎬 Complete playlist covering all major features and workflows
From Bottleneck to Pipeline
Traditional benthic imagery analysis is time-consuming. Manual annotation, data management, and model training are often separate, complex tasks. CoralNet-Toolbox unifies this process, turning a research bottleneck into an integrated, AI-accelerated pipeline.
**🎯 Patch Annotation** |
**📐 Rectangle Annotation** |
**🔷 Multi-Polygon Annotation** | |:---:|:---:|:---:| ### 🤖 **AI-Powered Analysis** |
**🧠 Image Classification** |
**🎯 Object Detection** |
**🎭 Instance Segmentation** | |:---:|:---:|:---:| ### 🔬 **Advanced Capabilities** |
**🪸 Segment Anything (SAM)** |
**🔍 Polygon Classification** |
**📍 Region-based Detection** | |:---:|:---:|:---:| ### ✂️ **Editing & Processing Tools** |
**✂️ Cut** |
**🔗 Combine** |
**🎨 Simplify** | |:---:|:---:|:---:|
🌊 Success Stories
Using CoralNet-Toolbox in your research?
We’d love to feature your work! Share your success stories to help others learn and get inspired.
🏗️ Repository Structure
🌍 About CoralNet
Coral reefs are among Earth’s most biodiverse ecosystems, supporting marine life and coastal communities worldwide. However, they face unprecedented threats from climate change, pollution, and human activities.
CoralNet is a revolutionary platform enabling researchers to:
- Upload and analyze coral reef photographs
- Create detailed species annotations
- Build AI-powered classification models
- Collaborate with the global research community
The CoralNet-Toolbox extends this mission by providing advanced AI tools that accelerate research and improve annotation quality.
📄 Citation
If you use CoralNet-Toolbox in your research, please cite:
@misc{CoralNet-Toolbox,
author = {Pierce, Jordan and Battista, Tim and Kuester, Falko},
title = {CoralNet-Toolbox: Tools for Annotating and Developing Machine Learning Models for Benthic Imagery},
year = {2025},
howpublished = {\url{https://github.com/Jordan-Pierce/CoralNet-Toolbox}},
note = {GitHub repository}
}
⚖️ Legal & Licensing
Empowering researchers • Protecting ecosystems • Advancing science