detecttechnologies / cvat

Powerful and efficient Computer Vision Annotation Tool (CVAT)

CVAT

Powerful and efficient Computer Vision Annotation Tool (CVAT)

Setup

Install Packages

• Install docker

sudo apt-get update
sudo apt-get --no-install-recommends install -y \
  apt-transport-https \
  ca-certificates \
  curl \
  gnupg-agent \
  software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository \
  "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) \
  stable"
sudo apt-get update
sudo apt-get --no-install-recommends install -y docker-ce docker-ce-cli containerd.io

• Perform post-installation steps to run docker without root permissions.

sudo groupadd docker
sudo usermod -aG docker $USER

• Install docker-compose (1.19.0 or newer).

sudo apt-get --no-install-recommends install -y python3-pip python3-setuptools
sudo python3 -m pip install setuptools docker-compose

Setup Cloud Mount (AWS)

• Install s3fs-fuse

sudo apt install s3fs

• Get AWS credentials and replace ACCESS_KEY_ID and SECRET_ACCESS_KEY in the following command

echo ACCESS_KEY_ID:SECRET_ACCESS_KEY > ${HOME}/.passwd-s3fs
chmod 600 ${HOME}/.passwd-s3fs

• Mount S3 path. Replace with your bucket name/

mkdir /home/ubuntu/cloud-mount
s3fs <bucket-name> /home/ubuntu/cloud-mount -o allow_other -o passwd_file=${HOME}/.passwd-s3fs

Clone CVAT

• Clone CVAT source code from the GitHub repository.

sudo apt-get --no-install-recommends install -y git
git clone -b dt-v2.1.0 https://github.com/detecttechnologies/cvat.git
cd cvat

• To access CVAT over a network or through a different system, export CVAT_HOST environment variable. Replace your-ip-address

export CVAT_HOST=your-ip-address

• Export Cloud Mount path

export CVAT_MOUNT=/home/ubuntu/cloud-mount

• Build and run docker containers

docker-compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.override.yml up --build -d

• Ignore if upgrading, Create superuser

docker exec -it cvat bash -ic 'python3 ~/manage.py createsuperuser'