Package: deeplabcut-docker
DeepLabCut Docker containersFor DeepLabCut 2.2.0.2 and onwards, we provide container containers onDockerHub. Using Docker is an alternative approach to using DeepLabCut, which only requires the user to installDockeron your machine, vs. following the step-by-step installation guide for a Anaconda setup. All dependencies needed to run DeepLabCut in terminal or GUI mode, or running Jupyter notebooks with DeepLabCut pre-installed are shipped with the provided Docker images.Advanced users can directly head toDockerHuband use the provided images there. To get started with using the images, we however also provide a helper tool,deeplabcut-docker, which makes the transition to docker images particularly convenient; to install the tool, run$pipinstalldeeplabcut-dockeron your machine (potentially in a virtual environment, or an existing Anaconda environment).
Note that this willnotdisprupt or install Tensorflow, or any other DeepLabCut dependencies on your computer---the Docker containers are completely isolated from your existing software installation!Usage modesWithdeeplabcut-docker, you can use the images in three modes.Note 1: When running any of the following commands first, it can take some time to complete (a few minutes, depending on your internet connection), since it downloads the Docker image in the background. If you do not see any errors in your terminal, assume that everything is working fine! Subsequent runs of the command will be faster.Note 2: The Terminal mode image can be used on all supported plattforms (Linux and MacOS). The GUI images can only be considered stable on Linux systems as of DeepLabCut 2.2.0.2 and need additional configuration on Mac.GUI modeTo run DeepLabCut in GUI mode and start the DeepLabCut GUI, simply run$deeplabcut-dockerguiwhich will pull the latest DeepLabCut version along with all dependencies, and afterwards opens the DeepLabCut GUI.The DeepLabCut version in this container is equivalent to the one you install withpip install "deeplabcut[gui]".Terminal modeIf you not need the GUI, you can run the light version of DeepLabCut and open a terminal by running$deeplabcut-dockerbashInside the terminal, you can confirm that DeepLabCut is correctly installed by running$ipython
>>>importdeeplabcut
>>>print(deeplabcut.__version__)2.2.0.2Jupyter Notebook modeFinally, you can run DeepLabCut by starting a jupyter notebook server. The corresponding image can be pulled and started by running$deeplabcut-dockernotebookwhich will start a Jupyter notebook server. Follow the terminal instructions to open the notebook, by enteringhttp://127.0.0.1:8888in your favorite browser. When prompted for a password, usedeeplabcut, which is the pre-set option in the container.The DeepLabCut version in this container is equivalent to the one you install withpip install deeplabcut[gui]. This means that you can start the DeepLabCut GUI with the appropriate commands in your notebook!Advanced usageAdvanced users and developers can visit the/dockersubdirectory in the DeepLabCut codebase on Github. We provide Dockerfiles for all images, along with build instructions there.Notes and troubleshootingRunning Docker with GUI support can vary across systems. The current images are confirmed to work with different Linux systems, but especially on MacOS additional configuration steps are necessary.When running containers on Linux, in some systems it might be necessary to runhost +local:dockerbefore starting the image viadeeplabcut-docker.If you encounter errors while using the images, please open an issue in the DeepLabCut repo---especially thedeeplabcut-dockeris still in its alpha version, and we appreciate user feedback to make the tool robust to use across many operating systems!