Saturn Cloud Quickstart

Get started using Saturn Cloud

Saturn Cloud is a data science platform that helps people quickly do work using whatever technology they need, including high-memory computing, GPU processors, and Dask clusters. You can use Saturn Cloud with Python, R, or nearly any other programming language.

Using this guide in just a few steps you will be able to run your data science code in the cloud and customize the environment however you need it

Sign up for Saturn Cloud

Sign up by visiting saturncloud.io and clicking on Start for Free. Follow the prompts and you’ll soon be logged in to your new account

Saturn Cloud homepage with arrows pointing to “Start for Free

If you are an Enterprise customer, you will need to use the custom url provided to you.

Saturn Cloud resources

A resource is a complete environment for running code. Each resource is independent, so you can split out the different types of activities you’re doing. You can have a resource for each project you’re working on, each analysis you’re doing, and so on.

A resource is one of the following:

  • Jupyter Server: This resource type allows you to interactively run code via JupyterLab or by connecting via SSH from an IDE like PyCharm or VSCode.
  • RStudio Server: If you are primarily doing R development, you can use an RStudio server to use the RStudio IDE.
  • Job: A task that runs on command or on a schedule. (Hosted Pro and Enterprise accounts only)
  • Deployment: A continuously running activity like a hosted dashboard or API. (Hosted Pro and Enterprise accounts only)
  • Prefect Cloud Flow: A special type of resource specific for running Prefect jobs which are created differently than the other types of resources. (Enterprise accounts only)

Each user can have multiple resources, and resources can be cloned (including by other users with sufficient permissions). Each resource may optionally have a Dask cluster associated with it, allowing the resource to run computations across multiple machines.

Creating a resource

When you log into Saturn Cloud you’ll first see the Resources page. On the Resources page you can see your existing resources, or create a new one in either of the following ways:

  • Set up your own custom resource with your specifications by pressing one of the New buttons at the top.
  • Select one of the pre-created template resources. These are set up to have the appropriate settings and code for a particular task.

Screenshot of the resource page

Start a resource

Once a resource is created, you’ll need to turn it on. Press the blue Start button on the resource’s page to start the server. If you have a Dask cluster attached to the resource, you’ll need to start that separately.

Screenshot of card in resource for Jupyter server with a rectangle around the start button

As your machine starts up, the card will display pending, and you will see a progress bar showing the steps and overall progress toward starting the server.

In the case of Jupyter server and RStudio servers, when the machine is ready the card will show running. You’ll see and the JupyterLab or RStudio button available so that you can use those IDES on the resource. For other resource types (jobs, deployments, or Prefect Cloud flows) the action that happens when the resource starts will be different.

Once you’re in the IDE, you can write, run, and save code. You can also connect your resource to git repositories to version control your code.

Stop the resource

When you’re done using the resource, shut it down by clicking the red Stop button on the card. By default, the resource will automatically shut off after the browser window has been inactive for an hour (this only applies to some resource types).

Next steps: customize Your resource

Creating and using resources is central to using on Saturn Cloud. There are many ways you can expand on them beyond using them as an interactive workspace for your code:

  • Install software and packages. If your code requires specific libraries or software to be installed on the resource then there are multiple methods of adding the dependencies.
  • Create a Dask cluster for the resource. One powerful feature of Saturn Cloud is the ability to leverage Dask clusters for distributed computing.
  • Connect a git repo. Connect a Saturn Cloud resource to your git repositories to run your code.
  • Add secrets to your resources. You may need to have secret credentials in your working environment to access tools or data. The Secrets section of the tools menu is where this information can be safely stored.
  • Use other IDEs (e.g., PyCharm, VSCode). Connect to a resource from your local IDE, using an SSH connection.
  • Create a custom image. Resources are built upon images with base software and packages. Many people use our standard images, which provide access to many data science packages. However, if, for example, your company has a designed Docker image, you can use that instead.
  • Schedule jobs and run deployments. Jobs and deployments are two other resource types. They let you schedule scripts to run or set up continuously running resources (e.g., APIs, dashboards). (Hosted Pro and Enterprise accounts only)