In this article:
- Create a Jupyter Notebook with Gradient°
- Run your Notebook
- Stop your Notebook
- View and Download your Artifacts
- Start your Notebook
- Delete your Notebook
- Collaborate on your Gradient Notebook
- Rename Your Notebook on the Fly
1a. Choose your Base Container
Click here to discover which Notebook Base Container will best suit your use case, then choose it from the options below:
1b. Choose what machine type your Notebook will run on
This is infrastructure that your notebook will run on. Our hardware is configured to work with the tools and packages in each of the provided containers. Unlike Paperspace CORE Virtual Machines, Virtual Machines that run Notebooks are managed by Paperspace.
After stopping a Notebook, it can be saved and relaunched on different compute type. This allows you to write code on a lower level machine and then test it with different GPU tiers.
1c. OPTIONAL: Low-Cost [Preemptible] Instances
A preemptible instance is a machine instance that is provided at a lower cost but can be interrupted by the cloud provider at any time. Click here to learn more.
notice preemptible instances have different options and prices:
1d. Name your Notebook
Provide a friendly name for your Notebook in the text field
1e. OPTIONAL: Auto-shutdown
If you are a Gradient 1 (or higher) subscriber, you will have the ability to set a custom auto-shutdown interval.
If you are a Gradient 0 subscriber, your notebook will default to an auto-shutdown interval of 12 hours, to help avoid unexpected runtime charges.
From the dropdown, you will be able to set auto-shutdown to 8 hours, 12 hours, 1 day, 1 week, or completely off.
Note: Once your Notebook is created it will quickly go from Pending to Running, and you're ready to get started! If you want to continue using your Notebook another time, be sure to click Stop so you're not charged.
Click Open to launch your Notebook in your local browser window. Check out Jupyter documentation here. Note that notebooks currently run for a maximum of 12 hour long sessions, after which it will automatically be shut down. (Custom settings coming soon!)
Note: Running a Jupyter Notebook Instance from within the Paperspace Native app will open Jupyter in your default web browser.
Click the "Stop" button to stop your Notebook from running. When your Notebook is stopped, the billing session will end. You'll see how long your Running Time was for the latest session.
Click in the gray space to the right of your Notebook name to reveal your Notebook Artifacts underneath. New artifacts are only available after you have stopped running your notebook.
Click any of the gray cloud icons at the far right of an artifact's row to download it.
5a. Starting A Notebook
Click Start, on any notebook that isn't running, to pick up from where you left off previously.
You'll be presented with a pop-up, allowing you to re-name the notebook, choose a different compute type, and/or set a different Auto-Shutdown limit. When you have made your changes, if any, click "START NOTEBOOK."
Your notebook will move from wherever it was in your list to the top.
5b. Forking A Notebook
Forking is a great way to make a carbon copy of your Notebook; to save a version of it that you may want to go back to in case you expect to make major changes.
Click the Fork icon to the right of a notebook:
You will see an exact copy of your notebook appear at the top of your Notebooks list:
Click Delete to remove your Notebook. Careful - this will permanently delete your Notebook!
You can only delete a notebook once it has stopped running.
Any notebook that exists on a team can be shared with team members, regardless of who creates it. To learn more about Teams, click here.
In the example below, Rusty's Colleague has forked a P4000 instance of Rusty's notebook and called it "Rusty's Notebook Copy":
Rusty, his Colleague, or anyone else on the team can Fork or Start this Notebook.
You can rename any Notebook, whether it is running or stopped, in order to help organize your work. Simply click on the notebook name in the list and it will become an editable text field; press the enter key when you are done to save it: