Skip to content
⚡️ML models version control, make them shareable and reproducible
Python Shell Inno Setup Other
Branch: master
Clone or download
Pull request Compare This branch is 3 commits ahead, 1398 commits behind iterative:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


DVC logo

WebsiteDocsTwitterChat (Community & Support)TutorialMailing List

Travis Windows Build Code Climate Codecov

Data Science Version Control or DVC is an open-source tool for data science and machine learning projects. With a simple and flexible Git-like architecture and interface it helps data scientists:

  1. manage machine learning models - versioning, including data sets and transformations (scripts) that were used to generate models;
  2. make projects reproducible;
  3. make projects shareable;
  4. manage experiments with branching and metrics tracking;

It aims to replace tools like Excel and Docs that are being commonly used as a knowledge repo and a ledger for the team, ad-hoc scripts to track and move deploy different model versions, ad-hoc data file suffixes and prefixes.

How DVC works

DVC is compatible with Git for storing code and the dependency graph (DAG), but not data files cache. To store and share data files cache DVC supports remotes - any cloud (S3, Azure, Google Cloud, etc) or any on-premise network storage (via SSH, for example).


Quick start

Please read Get Started for the full version. Common workflow commands include:

Step Command
Track code and data together
$ git add
$ dvc add
Connect code and data by commands
$ dvc run -d -o images/ unzip -q
$ dvc run -d images/ -d -o model.p python
Make changes and reproduce
$ vi
$ dvc repro model.p.dvc
Share code
$ git add .
$ git commit -m 'The baseline model'
$ git push
Share data and ML models
$ dvc remote add myremote s3://mybucket/image_cnn
$ dvc config core.remote myremote
$ dvc push


There are three options to install DVC: pip, Homebrew, or an OS-specific package:

pip install dvc


Self-contained packages for Windows, Linux, Mac are available. The latest version of the packages can be found at GitHub releases page.


$ brew install iterative/homebrew-dvc/dvc


$ brew cask install iterative/homebrew-dvc/dvc


Unofficial package, any inquiries regarding the AUR package, refer to the maintainer.

$ yay -S dvc

Related technologies

  1. Git-annex - DVC uses the idea of storing the content of large files (that you don't want to see in your Git repository) in a local key-value store and uses file hardlinks/symlinks instead of the copying actual files.
  2. Git-LFS - DVC is compatible with any remote storage (S3, Google Cloud, Azure, SSH, etc). DVC utilizes reflinks or hardlinks to avoid copy operation on checkouts which makes much more efficient for large data files.
  3. Makefile (and its analogues). DVC tracks dependencies (DAG).
  4. Workflow Management Systems. DVC is a workflow management system designed specifically to manage machine learning experiments. DVC is built on top of Git.


Contributions are welcome! Please see our Contributing Guide for more details.

0 1 2 3 4 5 6 7

Mailing List

Want to stay up to date? Want to help improve DVC by participating in our ocassional polls? Subscribe to our mailing list. No spam, really low traffic.


This project is distributed under the Apache license version 2.0 (see the LICENSE file in the project root).

By submitting a pull request for this project, you agree to license your contribution under the Apache license version 2.0 to this project.

You can’t perform that action at this time.