Skip to content

Installation

MBARI

DeepSea-AI currently supports:

  • Training YOLOv5 object detection models
  • Processing video with YOLOv5 detection and tracking pipelines using either:

There are three main requirements to use this module:

  1. An account with AWS Amazon Web Services.
  2. An account with Docker.
  3. Install and update using pip in a Python>=3.8.0 environment:

After you have setup your AWS account, configure it using the awscli tool

pip install awscli
aws configure
aws --version

Then install the module

pip install -U deepsea-ai

Setting up the AWS environment is done with the setup mirror command. This only needs to be done once, or when you upgrade the module and need the latest docker images. This command will setup the appropriate AWS permissions and mirror the images used in the commands from Docker Hub to your ECR Elastic Container Registry.

Be patient - this takes a while, but only needs to be run once.

deepsea-ai setup --mirror

Tutorials

  • FathomNet ✨ Recommended first step to learn more about how to train a YOLOv5 object detection model using freely available FathomNet data
  • Processing video with YOLOv5 ✨ Recommended first step to learn more about how to process video with YOLOv5

Create the Anaconda environment

The fastest way to get started is to use the Anaconda environment. This will create a conda environment called deepsea-ai and make that available in your local jupyter notebook as the kernel named deepsea-ai

conda env create 
conda activate deepsea-ai
pip install ipykernel
python -m ipykernel install --user --name=deepsea-ai

Launch jupyter

cd docs/notebooks
jupyter notebook

Commands

Source code is available at github.com/mbari-org/deepsea-ai.

For more details, see the official documentation.