Quick Start

Prerequisites

To begin using Gradient, follow these preliminary steps:
  1. 2.
    Optional: Create a team to invite collaborators
Now you can create Notebooks, Workflows, Deployments, and more!

Logging in for the first time

When you first log into the Paperspace Console, you can select Gradient from the product dropdown:

First Create a Project

Projects help organize your work. To get started, just choose a name and click create.

Create a Notebook

After creating a Project, Notebooks can be created on the Notebooks tab within the Project. Just select a template, choose your instance type, and then click create.
Check out the FREE GPU option when launching Notebooks!
Check out the ML Showcase for a list of projects you can fork into your own account
You can stop, start, fork, and swap out the instance type anytime. Choose from a wide selection of pre-configured templates or bring your own.

Create a Workflow

You can automate machine learning tasks using Workflows. You can define a workflow once and use it repeatedly to perform simple or complex MLOps activities, such as pre-processing data, training models, and creating or updating deployments.
This requires the project to be linked to a GitHub repository. Follow the instructions on the page to install the Gradient Github App into your Github account, and select the git repo you want to associate with project. Alternatively you can select one of the sample repos.
If you choose to use your own git repo, you will be prompted to add a YAML file to your repo that defines the Workflow steps.

Run a Workflow from the CLI (advanced)

  1. 3.
    Create a Workflow
    This step is only needed if you didn't already create a default demo workflow in the web interface. Specify a name for the Workflow and a projectId. Use the projectId from the project you created earlier.
    1
    gradient workflows create \
    2
    --name <your-workflow-name> \
    3
    --projectId <your-project-id>
    Copied!
    To see a list of your projects and projectIds run gradient projects list. For a list of Workflows within a project run gradient workflows list --projectId <your-project-id>.
  2. 4.
    Download or copy the sample Workflow Spec to your computer
    Here is the Workflow Spec for reference:
    1
    jobs:
    2
    CloneRepo:
    3
    resources:
    4
    instance-type: C5
    5
    outputs:
    6
    repo:
    7
    type: volume
    8
    9
    with:
    10
    url: https://github.com/NVlabs/stylegan2.git
    11
    StyleGan2:
    12
    resources:
    13
    instance-type: P4000
    14
    needs:
    15
    - CloneRepo
    16
    inputs:
    17
    repo: CloneRepo.outputs.repo
    18
    outputs:
    19
    generatedFaces:
    20
    type: dataset
    21
    with:
    22
    ref: demo-dataset
    24
    with:
    25
    script: |-
    26
    pip install scipy==1.3.3
    27
    pip install requests==2.22.0
    28
    pip install Pillow==6.2.1
    29
    cp -R /inputs/repo /stylegan2
    30
    cd /stylegan2
    31
    python run_generator.py generate-images \
    32
    --network=gdrive:networks/stylegan2-ffhq-config-f.pkl \
    33
    --seeds=6600-6605 \
    34
    --truncation-psi=0.5 \
    35
    --result-dir=/outputs/generatedFaces
    36
    image: tensorflow/tensorflow:1.14.0-gpu-py3
    Copied!
    Place the contents in a file named workflow.yaml.
  3. 5.
    Run the Workflow from the CLI
    The following command will run an instance of the Workflow in your project. Be sure to replace <your-workflow-id> with your Workflow ID.
    1
    gradient workflows run \
    2
    --id <your-workflow-id> \
    3
    --path ./workflow.yaml
    Copied!
Note: We recommend stashing your API key with gradient apiKey XXXXXXXXXXXXX or you can add your API key as an option on each command. See Connecting Your Account.
Behind the scenes, your Workflow will be executed on the Gradient public cluster. Congratulations! You ran your first Workflow on Gradient 🚀

Explore the rest of the platform

From Models to Deployments, there's a lot more to the Gradient platform. We recommend using the Web UI to explore the primary components, including Notebooks, and basic usage of Workflows & Deployments. For more advanced non-GUI-based usage, be sure to install the CLI and check out the SDK.
Last modified 3mo ago