CVAT: Computer Vision Annotation Toolインストールメモ

OpenCVが開発しているCVAT(Computer Vision Annotation Tool)のインストールメモ。Dockerを使うのでインストールはとても簡単。ライセンスはMIT Licenseなので使いやすい。次の公式サイトのInstallation Guideの説明に従ってインストールした。特に問題がなかったので、この記事はInstallation Guideを意訳したものになっているので、公式サイトのInstallation Guideに従ってインストールするのが良い。英語が苦手は方は参考になるかもしれない。

公式サイト

• Powerful and efficient Computer Vision Annotation Tool (CVAT)
• Installation Guide

環　境

• Razer  Blade 15 (2018)
• Ubuntu 18.04
• Kernel 5.3.0-40-generic
• Python 3.6.9
• Google Chrome：ウェブブラウザはChromeしか対応していない。

インストール

1. 端末を開き、次のコマンドを実行してdockerをインストールする。
   • $ sudo apt update
   • $ sudo apt 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 update
   • $ sudo apt install -y docker-ce docker-ce-cli containerd.io
2. ルート権限がなくてもdockerを実行できるように設定する。
   • $ sudo groupadd docker
   • $ sudo usermod -aG docker $USER
   • ログアウト、再ログインしてdockerがグループに追加されたか次のコマンドで確認する。dockerが表示されればOK。
     • $ groups
3. docker-compose (1.19.0以上)をインストールする。docker-composeは複数のコンテナを定義したり実行したりするためのdockerのツール。
   • $ sudo apt install -y python3-pip
   • $ sudo python3 -m pip install docker-compose
4. CVATのソースコードをGitHubのレポジトリからクローンする。
   • $ cd  ~/src
   • $ git clone https://github.com/opencv/cvat
   • $ cd cvat
5. 次のコマンドでdockerのイメージをビルドする。Ubuntu16.04のdockerイメージとCVATサーバーを実行するために必要な全てのファイルをダウンロードする。
   • $ docker-compose build
6. dockerコンテナの実行
   • $ docker-compose up -d
7.  管理者(superuser)の生成
   • $ docker exec -it cvat bash -ic 'python3 ~/manage.py createsuperuser'
   • 管理者アカウントのパスワードを決める。詳細はDjangoドキュメントを参照。なお、DjangoはWEBアプリケーションを開発するためのフレームワークで、CVATに使われている。
8. Google Chromeのインストール。CVATはChromeしか対応していないので、インストールしていない以下のコマンドでインストールをする。
   • • $ curl https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add –
     • $ sudo sh -c ‘echo “deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main” >> /etc/apt/sources.list.d/google-chrome.list’
     • $ sudo apt-get update
     • $ sudo apt-get install -y google-chrome-stable

実　行

• CVATをdockerでインストールしたので、次のコマンドでCVATのdockerコンテナを起動する。-dのオプションをつけるとバックグラウンドで実行するので、実行した端末で作業を続けることができる。
  • $ cd ~/src/cvat
  • $ docker-compose up -d
• CVATはサーバーアプリケーションなので、CVATを起動したらChromeを起動して、localhost:8080にアクセスする。
• 管理者としてログインしてパスワードを入力する。これでアノテーション作業が可能となる。詳細は以下のリンクを参照。CVATのドキュメントはとても詳しい。
  • CVAT User Guide

終わり