Skip to content
/ dvc Public
forked from iterative/dvc

⚡️Data & models versioning for ML projects, make them shareable and reproducible

License

Notifications You must be signed in to change notification settings

jeremcs/dvc

Repository files navigation

https://img.shields.io/travis/iterative/dvc/master.svg?label=Linux%20%26%20Mac%20OS https://img.shields.io/appveyor/ci/iterative/dvc/master.svg?label=Windows

Data Version Control or DVC is an open source tool for data science projects. It helps data scientists manage their code and data together in a simple form of Git-like commands.

Get started

Step Command
Track code and data together
$ git add train.py
$ dvc add images.zip
Connect code and data by commands
$ dvc run -d images.zip -o images/ unzip -q images.zip
$ dvc run -d images/ -d train.py -o model.p python train.py
Make changes and reproduce
$ vi train.py
$ 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 core.remote myremote
$ dvc push

See more in tutorial.

Installation

Packages

Operating system dependent packages are the recommended way to install DVC. The latest version of the packages can be found at GitHub releases page: https://github.com/iterative/dvc/releases

Python Pip

DVC could be installed via the Python Package Index (PyPI).

pip install dvc

Homebrew (Mac OS)

Formula:

brew install iterative/homebrew-dvc/dvc

Cask:

brew cask install iterative/homebrew-dvc/dvc

Links

Website: https://dataversioncontrol.com

Tutorial: https://blog.dataversioncontrol.com/data-version-control-tutorial-9146715eda46

Documentation: http://dataversioncontrol.com/docs/

Discussion: https://discuss.dataversioncontrol.com/

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.
  3. Makefile (and it's analogues). DVC tracks dependencies (DAG).
  4. Workflow Management Systems. DVC is workflow management system designed specificaly to manage machine learning experiments. DVC was built on top of Git.

DVC is compatible with Git for storing code and the dependency graph (DAG), but not data files cache. Data files caches can be transferred separately - now data cache transfer throught AWS S3 and GCP storge are supported.

How DVC works

how_dvc_works

Copyright

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.

About

⚡️Data & models versioning for ML projects, make them shareable and reproducible

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 94.5%
  • Shell 3.2%
  • Inno Setup 1.7%
  • Other 0.6%