Installation on macOS

To use DVC as a Python library, you can install it with pip or with conda.

To use DVC on ARM (Apple Silicon) macOS, you must install with homebrew or with pip. The PKG binary and conda installation methods can only be used on x86 (Intel) macOS.

Install with brew

Recommended. Requires Homebrew.

$ brew install dvc

Install from package

Get the PKG (binary) from the big "Download" button on the home page.

Note that currently, in order to open the PKG file, you must go to the Downloads directory in Finder and do a secondary click on it, then select "Open With" > Installer.app, and click the Open button.

You may try these instructions to uninstall the macOS package.

Install with pip

We strongly recommend creating a virtual environment or using pipx to encapsulate your local environment.

Note that Python 3.8+ is needed to get the latest version of DVC.

$ pip install dvc

Depending on the type of the remote storage you plan to use, you might need to install optional dependencies: [s3], [gdrive], [gs], [azure], [ssh], [hdfs], [webdav], [oss]. Use [all] to include them all.

Example: with support for Amazon S3 storage

$ pip install "dvc[s3]"

In this case it installs the boto3 library along with DVC.

Install with conda

Requires Miniconda or Anaconda Distribution.

$ conda install -c conda-forge mamba # installs much faster than conda
$ mamba install -c conda-forge dvc

Depending on the type of the remote storage you plan to use, you might need to install optional dependencies: dvc-s3, dvc-azure, dvc-gdrive, dvc-gs, dvc-oss, dvc-ssh.