.. raw:: html

|Hex.pm| |Build.pm|

Studio is a model management framework written in Python to help simplify and expedite your model building experience. It was developed to minimize the overhead involved with scheduling, running, monitoring and managing artifacts of your machine learning experiments. No one wants to spend their time configuring different machines, setting up dependencies, or playing archeologist to track down previous model artifacts.

Most of the features are compatible with any Python machine learning framework (Keras <https://github.com/fchollet/keras>, TensorFlow <https://github.com/tensorflow/tensorflow>, PyTorch <https://github.com/pytorch/pytorch>, scikit-learn <https://github.com/scikit-learn/scikit-learn>, etc); some extra features are available for Keras and TensorFlow.

Use Studio to:

• Capture experiment information- Python environment, files, dependencies and logs- without modifying the experiment code.
• Monitor and organize experiments using a web dashboard that integrates with TensorBoard.
• Run experiments locally, remotely, or in the cloud (Google Cloud or Amazon EC2)
• Manage artifacts
• Perform hyperparameter search
• Create customizable Python environments for remote workers.

NOTE: studio package is compatible with Python 2 and 3!

Example usage

Start visualizer:

::

studio ui

Run your jobs:

::

studio run train_mnist_keras.py

You can see results of your job at http://localhost:5000. Run studio {ui|run} --help for a full list of ui / runner options. WARNING: because studio tries to create a reproducible environment for your experiment, if you run it in a large folder, it will take a while to archive and upload the folder.

Installation

pip install studioml from the master pypi repositry:

::

pip install studioml

Find more details <installation.rst>__ on installation methods and the release process.

Authentication

Currently Studio supports 2 methods of authentication: email / password <authentication.rst#email--password-authentication> and using a Google account. <authentication.rst#google-account-authentication> To use studio runner and studio ui in guest mode, in studio/default_config.yaml, uncomment "guest: true" under the database section.

Alternatively, you can set up your own database and configure Studio to use it. See setting up database <setup_database.rst>__. This is a preferred option if you want to keep your models and artifacts private.

Further reading and cool features

• Running experiments remotely <http://docs.studio.ml/en/latest/remote_worker.html>__

  • Custom Python environments for remote workers <http://docs.studio.ml/en/latest/customenv.html>__

• Running experiments in the cloud <http://docs.studio.ml/en/latest/cloud.html>__

  • Google Cloud setup instructions <http://docs.studio.ml/en/latest/glcloud_setup.html>__

  • Amazon EC2 setup instructions <http://docs.studio.ml/en/latest/ec2_setup.html>__

• Artifact management <http://docs.studio.ml/en/latest/artifacts.html>__

• Hyperparameter search <http://docs.studio.ml/en/latest/hyperparams.html>__

• Pipelines for trained models <http://docs.studio.ml/en/latest/model_pipelines.html>__

• Containerized experiments <http://docs.studio.ml/en/latest/containers.html>__

.. |Hex.pm| image:: https://img.shields.io/hexpm/l/plug.svg :target: https://github.com/studioml/studio/blob/master/LICENSE

.. |Build.pm| image:: https://travis-ci.org/studioml/studio.svg?branch=master :target: https://travis-ci.org/studioml/studio.svg?branch=master