Quick Start
Last updated
Last updated
To begin using Gradient, follow these preliminary steps:
Optional: to invite collaborators
Now you can create Notebooks, Workflows, Deployments, and more!
When you first log into the Paperspace Console, you can select Gradient from the product dropdown:
Projects help organize your work. To get started, just choose a name and click create.
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.
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.
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.
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>
.
Download or copy the sample Workflow Spec to your computer
Here is the Workflow Spec for reference:
Place the contents in a file named workflow.yaml
.
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.
Behind the scenes, your Workflow will be executed on the Gradient public cluster. Congratulations! You ran your first Workflow on Gradient 🚀
After creating a Project, Notebooks can be created on the Notebooks tab within the Project. Just select a , choose your , and then click create.
Check out the option when launching Notebooks!
Check out the for a list of projects you can fork into your own account
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 .
From to , 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 and check out the .