Skip to content

Commit

Permalink
remove mlflow from README (#64) (#65)
Browse files Browse the repository at this point in the history
* remove mlflow from README

* add tensorboard information

Co-authored-by: Jeremy Pinto <[email protected]>
  • Loading branch information
mirkobronzi and jerpint authored Aug 9, 2022
1 parent f7840bd commit 354f2ad
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 12 deletions.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,13 @@ About

A cookiecutter is a generic project template that will instantiate a new project with sane defaults. This repo contains our custom cookiecutter (`cookiecutter-pyml`) which will generate a new python deep learning package preconfigured with best practices in mind. It currently supports:

* Pytorch(PyTorch Lightning)
* Travis CI
* Pytorch (PyTorch Lightning)
* Github Actions (CI/CD)
* Sphinx (documentation)
* MLFlow (experiment management)
* Tensorboard (experiment tracking)
* Orion (hyperparameter optimization)
* Flake8
* Pytest
* Flake8 (linting)
* Pytest (unit testing)

More information on what a cookiecutter is [here.](https://cookiecutter.readthedocs.io)

Expand Down
16 changes: 9 additions & 7 deletions {{cookiecutter.project_slug}}/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,11 +100,14 @@ For example, to run on your local machine without Orion:
This will run a simple MLP on a simple toy task: sum 5 float numbers.
You should see an almost perfect loss of 0 after a few epochs.

Note you have two new folders now:
* output: contains the models and a summary of the results.
* mlruns: produced by mlflow, contains all the data for visualization.
You can run mlflow from this folder (`examples/local`) by running
`mlflow ui`.
Note you have a new `output` folder which contains models and a summary of results:
* best_model: the best model checkpoint during training
* last_model: the last model checkpoint during training
* lightning_logs: contains the tensorboard logs.

To view tensorboard logs, simply run:

tensorboard --logdir output

#### Run on a remote cluster (with Slurm)

Expand Down Expand Up @@ -181,8 +184,7 @@ file (`config.yaml`) for your project (that contains the hyper-parameters).
In general, you will want to run Orion in parallel over N slurm jobs.
To do so, simply run `sh run.sh` N times.

When Orion has completed the trials, you will find the orion db file and the
mlruns folder (i.e., the folder containing the mlflow results).
When Orion has completed the trials, you will find the orion db file.

You will also find the output of your experiments in `orion_working_dir`, which
will contain a folder for every trial.
Expand Down

0 comments on commit 354f2ad

Please sign in to comment.