Quick start

📍 Quick start with SavviHub Client

SavviHub example GitHub repository: https://github.com/savvihub/examples

1. Sign-up and create an organization

For the first journey with SavviHub please Sign-up in SavviHub Web Console and create an organization.

2. Create a project

Fork the SavviHub examples GitHub repository to your GitHub account, and create a version control project namedexamples from your GitHub repository in SavviHub Web Console.

3. Install SavviHub Client

Next, pip install the SavviHub Client on your local machine. SavviHub Client is a unified tool to manage SavviHub resources. It includes:

  • Command Line Interface (CLI): handling dataset and experiment

  • Python SDK: logging experiment metrics

pip install savvihub

4. Git clone a repository and login to SavviHub Client

Clone the SavviHub GitHub repository and login with SavviHub Client.

git clone https://github.com/{your-github-account}/examples.git
cd examples
savvihub login

5. Run an experiment

Run experiment command on your local machine with either command options or inquirers.

Run with options
Run with inquirers
Run with options
sv experiment run \
-c aws-apne2-prod1 \
-r c2.r6.spot \
-i savvihub/kernels:py36.full-cpu \
--start-command 'pip install -r mnist/requirements.txt && python mnist/keras/main.py --save-model --save-image'
Run with inquirers
sv experiment run
[?] Start command: pip install savvihub && python mnist/keras/main.py --save-model
[?] Please choose a cluster: [1] aws-apne2-prod1 (SavviHub)
> [1] aws-apne2-prod1 (SavviHub)
[?] Please choose a resource: [1] c2.r6.spot (CPU 2 Cores / Memory 6GB)
> [1] c2.r6.spot (CPU 2 Cores / Memory 6GB)
[2] c2.r6 (CPU 2 Cores / Memory 6GB)
[3] c4.r13 (CPU 4 Cores / Memory 13GB)
[4] g1a.r6 (GPU(K80) x 1 / CPU 2 Cores / Memory 6GB)
[5] g2a.r13 (GPU(K80) x 2 / CPU 4 Cores / Memory 13GB)
[6] g1b.r13 (GPU(V100) x 1 / CPU 4 Cores / Memory 13GB)
[7] g2b.r13 (GPU(V100) x 2 / CPU 4 Cores / Memory 13GB)
[8] c0.r1 (CPU shared / Memory 1GB)
[?] Please choose a kernel image: [1] savvihub/kernels:py36.full-cpu (Python 3.6 (All Packages))
> [1] savvihub/kernels:py36.full-cpu (Python 3.6 (All Packages))
[2] savvihub/kernels:py37.full-cpu (Python 3.7 (All Packages))
[3] savvihub/kernels:py36.full-cpu.jupyter (Python 3.6 (JupyterLab))
[4] savvihub/kernels:py37.full-cpu.jupyter (Python 3.7 (JupyterLab))
[5] tensorflow/tensorflow:1.14.0-py3 (Tensorflow 1.14.0)
[6] tensorflow/tensorflow:1.15.5-py3 (Tensorflow 1.15.5)
[7] tensorflow/tensorflow:2.0.4-py3 (Tensorflow 2.0.4)
[8] tensorflow/tensorflow:2.2.1-py3 (Tensorflow 2.2.1)
[9] tensorflow/tensorflow:2.3.2 (Tensorflow 2.3.2)
[10] tensorflow/tensorflow:2.4.1 (Tensorflow 2.4.1)
[11] tensorflow/tensorflow:2.3.0 (TensorFlow 2.3.0 (Tensorboard))
Run experiment with revision 8a6f65c (HEAD)
Commit: 8a6f65c Update keras mnist example (2 minutes ago) <ryooit>
Experiment 1 is running. Check the experiment status at below link

6. Monitor your experiment in SavviHub Web Console

Congratulations! Now you run the first experiment in SavviHub! Go to the SavviHub Web Console and have some insights into your experiment.