Edit on GitHub


Alias of dvc experiments.

A set of commands to generate and manage experiments: run, show, diff, apply, branch, remove, push, pull, list, and clean.

Requires that Git is being used to version the project.


usage: dvc exp [-h] [-q | -v]

positional arguments:
    show                Print experiments.
    run                 Run or resume an experiment.
    apply               Apply the changes from an experiment to your workspace.
    branch              Promote an experiment to a Git branch.
    clean               Cleanup experiments temporary internal files.
    diff                Show changes between experiments.
    list                List local and remote experiments.
    pull                Pull an experiment from a Git remote.
    push                Push a local experiment to a Git remote.
    remove              Remove experiments.
    save                Save current workspace as an experiment.


dvc exp subcommands provide specialized ways to create and manage data science/ machine learning experiments.

See Experiment Management for more info.

Note that DVC assumes that experiments are deterministic (see Avoiding unexpected behavior).


  • -h, --help - prints the usage/help message, and exit.

  • -q, --quiet - do not write anything to standard output.

  • -v, --verbose - displays detailed tracing information.


๐Ÿ› Found an issue? Let us know! Or fix it:

Edit on GitHub

โ“ Have a question? Join our chat, we will help you:

Discord Chat