Skip to main content

Simple helper for reproducible (research) experiments.

Project description


Simple helper for reproducible (research) experiments.


This package aims to make one's life easier with machine learning experiments. To achieve this goal, this package basically does the following two things.

1. Run experiments with some config files.

  • No need for long commands.
  • Reliable and elegant than notebooks.

2. Built-in support to record, view, and reproduce your experiments.


Quick start


Core features

  1. Define your experiment in a human friendly YAML file: main function, parameters, data files, logging, etc.
  2. Codes will be automatically checked in to git with proper tags. Datas will be also version-controlled in a proper manner.
  3. Each experiment will be dumped into a database, including the config, the logging, and the versions of code and data.


Config file

The config file includes:

  • main function and parameters
  • misc
    • experiment name
    • logging

Version control

The goal is to re-run one experiment within one command. To achieve this, we will have both codes and data versioned in a proper way.

Codes All local changes, if there are any, will be committed into Git before a config runs. Commits information will be stored in log files and the head commit will be tagged as f"{name}@{time}" for future reference.

Data Data will be stored in the database, which will be keyed by name and md5 value.


The database has two parts: experiment logging and version control.

  1. Experiment logging shows what experiments have been conducted, what's the input/output of one experiment. Based on it, more analysis can be elaborated.
  2. Version control is responsible for recording all versions of codes (through Git) and data (local storage).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for move-carrots, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size move_carrots-0.1.1-py3-none-any.whl (3.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size move-carrots-0.1.1.tar.gz (2.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page