Skip to main content
Version: 1.0.0

Get started with Workspaces

Check your docs version

Anyscale is rolling out a new design. If you have preview access to the enhanced experience, use the latest version of the docs and see the migration guide for transitioning.

Workspace is a fully managed development environment that enables ML practitioners to build distributed Ray applications and advance from research to development to production easily, all within a single environment. It greatly boosts developers' productivity and accelerates the dev-to-prod lifecycles by enabling them to:

  • Leverage familiar development tools
  • Program on a scalable cluster like on a laptop
  • Develop and debug in an environment consistent with production
  • Collaborate efficiently

Conceptual overview


Workspaces consists of an Anyscale-managed Ray cluster, environment, storage, and development tools (IDEs, Git, etc.)

  • Ray cluster: Anyscale-managed Ray clusters provide the underlying compute that can horizontally scale up and down.
    • Head node: each Ray cluster has exactly one head node. In the context of Workspace, the head node hosts various development tools (see below) and is responsible for distributing workload to worker nodes at runtime.
    • Worker nodes: depends on the Compute Config of the Workspace, there could be zero or more worker nodes at a given time that are orchestrated by the head node to run your applications.
  • Development tools: Workspaces host or integrate with tools like JupyterLab, VS Code, Git, Weights & Biases, etc.
  • Storage: storage (Network File System (NFS)) persists your application code and allows the entire cluster to access the data.
  • Environment and dependencies: different environment management options help manage your application dependencies.

Get started with Workspaces

Create a Workspace

  1. Log into Anyscale console and open the Workspace page from the left navigation bar.
  2. Click "Create" to create a new Workspace.
  3. Give a name to your Workspace.
  4. Use the default cluster environment and compute config or choose custom ones.
  5. Start the Workspace.

Run a "Hello, world" example

After the Workspace is started, the Web Terminal will show up.

Web Terminal

Run echo "hello, world" and you should be able to see your first greeting from the Anyscale Workspace.

Clean up the resources

Terminate the Workspace after you are done.