# Using Notebooks {% tabs %} {% tab title="Web UI" %} ## Create a Notebook {% embed url="" %} ### Choose your Base Container Notebooks can be created by clicking *Create Notebook* button on the Notebooks tab. There are three types of base containers: #### Recommended Containers (Basic) These are the templates that are most popular on Gradient. They include the most common ML frameworks and libraries. [Click here](https://paperspace.gitbook.io/gradient/master/notebooks/create-a-notebook/notebook-containers) to discover which Notebook Base Container will best suit your use case, then choose it from the options below: ![Recommended containers](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MRO72xWYUzow-e2sk3f%2F-MRO7muCgQsns4KjRl5l%2FScreen%20Shot%202021-01-18%20at%209.34.22%20PM.png?alt=media\&token=8dd7167a-58e6-414b-8dfa-43cd20944ee7) #### All Containers (Basic) These are additional templates that are made available in Gradient as a 1-click option. [Click here](https://paperspace.gitbook.io/gradient/master/notebooks/create-a-notebook/notebook-containers) to discover which Notebook Base Container will best suit your use case, then choose it from the options below: ![All containers](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MRO72xWYUzow-e2sk3f%2F-MRO7ygu5_ZPiVuuZA3k%2FScreen%20Shot%202021-01-18%20at%209.35.10%20PM.png?alt=media\&token=12cfd155-a528-418e-903a-9a0a718d6b1f) #### Custom Containers (Advanced) If you need to import an existing container, visit the Custom Containers section. Learn more [here](https://paperspace.gitbook.io/gradient/master/notebooks/create-a-notebook/notebook-containers). ![Enter a custom container by enabling Advanced options](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MRO72xWYUzow-e2sk3f%2F-MRO8Bxq-LwrqEpWT63x%2FScreen%20Shot%202021-01-18%20at%209.36.07%20PM.png?alt=media\&token=f65702b8-a0fa-4a2f-9160-2a7ddbdcf259) ### Choose the instance type This is [instance type](https://paperspace.gitbook.io/gradient/master/instances/instance-types) that your notebook will run on. Our hardware is configured to work with the tools and packages in each of the provided containers. ![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MW5JIXNksMFRzi8xZ_Z%2F-MW5MtYzEbAj-25HI_mB%2Fimage.png?alt=media\&token=125f7ec4-c85b-4341-9c59-13457b73abb8) ### Optional Settings: #### Name your Notebook Provide a friendly name for your Notebook in the text field #### Auto-shutdown If you have a [Gradient subscription](https://gradient.paperspace.com/pricing), you will have the ability to set a custom auto-shutdown interval. **Workspace** Additionally, you have the option to select a remote Github repository to serve as the starting point for your Notebook. If the repository is private, you need to provide access credentials (username and a password/apiKey). Also, you can provide an optional Github ref that points to a specific version of the repository. ### Click Create That's it! Your Notebook will start once it has been created 🚀 Once created, your Notebook will automatically start. Just click *Open* and your Notebook will appear in a new browser tab. {% endtab %} {% tab title="CLI" %} ## Create a Notebook ### Syntax ```bash gradient notebooks create [options...] ``` ### Notebook Parameters Basics * Machine Type: Such as `--P100` or `--C7` or `--TPU` * Container: Such as `--tensorflow/tensorflow:1.5.1-gpu` ### Example Use ```bash Usage: gradient notebooks create \ --name "my job" \ --container "http://dockerhub.com/mycontainer" \ --machineType "P5000" \ --command "/paperspace/run.sh" --projectId "someProjectID" ``` ## Notebook Parameters Complete List | Argument | Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `name` | Notebook name | | `projectId` | Project ID | | `machineType` | An optional machine type to run the job on: either 'GPU+', 'P4000', 'P5000', 'P6000', 'V100', 'K80', 'P100', or 'TPU'. \[Required] | | `container` | A reference to a docker image in a public or private docker registry. Docker image repository references must be in lowercase and may include a tag and a hostname prefix followed by a slash; if committed the hostname defaults to that of the public Docker Hub registry. An example docker image reference: `docker.io/mynamespace/myimage:mytag`. A container name may be mixed case. \[Required] | | `containerUser` | Container user | | `command` | Command (executed as `/bin/sh -c 'YOUR COMMAND'`) | | `clusterId` | ID of the cluster to run the notebook. | | `registryUsername` | Registry username | | `registryPassword` | Registry password | | `shutdownTimeout` | Shutdown timeout in hours | | `isPreemptible` | Use a preemptible instance type | | `tag` | One or multiple tags that you want to add to the notebook | | `workspace` | S3 url or git repository. Directory uploads are not yet supported`apiKey` | | `workspacePassword` | Workspace password | | `workspaceRef` | Git commit hash, branch name or tag | | `environment` | Environment variables | | `shutdownTimeout` | Shutdown timeout in hours | | `apiKey` | API key to use this time only | | {% endtab %} | | | {% endtabs %} | | {% tabs %} {% tab title="Web UI" %} ## Start a Notebook ![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MW5JIXNksMFRzi8xZ_Z%2F-MW5NO_c7rt9JtI67xDW%2Fimage.png?alt=media\&token=6053edab-a79c-41ce-ab3a-2f93aef8d0e6) When you click *Start*, a window will appear that presents a few options such as the name, the instance type, and the Auto-Shutdown interval. {% endtab %} {% tab title="CLI" %} ## Start a Notebook Start a *stopped* notebook again. The notebook can be started on a different cluster or machine type. ### Syntax ```bash gradient notebooks start [options...] ``` **Options:** | Option | Description | | ----------------- | ------------------------------------------------- | | `id` | Notebook ID \[required] | | `machineType` | Virtual Machine type label e.g. P5000 \[required] | | `clusterId` | Cluster ID | | `name` | Notebook name | | `shutdownTimeout` | Shutdown timeout in hours | | {% endtab %} | | | {% endtabs %} | | {% tabs %} {% tab title="Web UI" %} ## Stop a Notebook 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. {% endtab %} {% tab title="CLI" %} ## Stop a Notebook Stop a *running* notebook. ### Syntax ```bash gradient notebooks stop [options...] ``` **Options:** | Option | Description | | ------------- | ----------------------------- | | `id` | Notebook ID \[required] | | `apiKey` | API key to use this time only | | {% endtab %} | | | {% endtabs %} | | {% tabs %} {% tab title="Web UI" %} ## Delete a Notebook Click Delete to remove your Notebook. Careful - this will permanently delete your Notebook! {% hint style="info" %} You can only delete a notebook once it has stopped running. {% endhint %} ![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MW5JIXNksMFRzi8xZ_Z%2F-MW5NZipOV4pIkWPH9g-%2Fimage.png?alt=media\&token=5093ad0e-bb60-4d74-9836-1dfae1064f1e) {% endtab %} {% tab title="CLI" %} ## Delete a Notebook Delete an existing notebook. ### Syntax ```bash gradient notebooks delete [options...] ``` **Options:** | Option | Description | | ------------- | ----------------------------- | | `id` | Notebook ID \[required] | | `apiKey` | API key to use this time only | | {% endtab %} | | | {% endtabs %} | | ## Rename a 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 and it will become an editable text field; press enter to commit the change: ![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MW5JIXNksMFRzi8xZ_Z%2F-MW5Nh4cWi70-Yn48SRP%2Fimage.png?alt=media\&token=8339e67a-18bf-4e86-b840-a52a06054482) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://paperspace.gitbook.io/gradient/master/notebooks/create-a-notebook.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.