> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runpod.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Running Runpod on SkyPilot

> Use SkyPilot to run LLMs, AI, and batch jobs on Runpod Pods and Serverless endpoints.

[SkyPilot](https://skypilot.readthedocs.io/en/latest/) is a framework for running LLMs, AI, and batch jobs on any cloud.

This integration uses the Runpod CLI infrastructure to spin up on-demand Pods and deploy Serverless endpoints with SkyPilot.

## Get started

<Steps>
  <Step title="Obtain your API key">
    Get your API key from the [Runpod Settings](https://www.console.runpod.io/user/settings) page.
  </Step>

  <Step title="Install Runpod">
    Install the latest version of Runpod:

    ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
    pip install "runpod>=1.6"
    ```
  </Step>

  <Step title="Configure Runpod">
    Run `runpod config` and paste your API key when prompted.
  </Step>

  <Step title="Install SkyPilot Runpod Cloud">
    Install the [SkyPilot Runpod cloud](https://skypilot.readthedocs.io/en/latest/getting-started/installation.html#runpod):

    ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
    pip install "skypilot-nightly[runpod]"
    ```
  </Step>

  <Step title="Verify your setup">
    Run `sky check` to verify your credentials are set up correctly.
  </Step>
</Steps>

## Run a project

<Steps>
  <Step title="Create a new project directory">
    Create a new directory for your project:

    ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
    mkdir hello-sky
    cd hello-sky
    ```
  </Step>

  <Step title="Create a configuration file">
    Create a file named `hello_sky.yaml` with the following content:

    ```yml theme={"theme":{"light":"github-light","dark":"github-dark"}}
    resources:
      cloud: runpod

    # Working directory (optional) containing the project codebase.
    # Its contents are synced to ~/sky_workdir/ on the cluster.
    workdir: .

    # Setup commands (optional).
    # Typical use: pip install -r requirements.txt
    # Invoked under the workdir (i.e., can use its files).
    setup: |
      echo "Running setup."

    # Run commands.
    # Typical use: make use of resources, such as running training.
    # Invoked under the workdir (i.e., can use its files).
    run: |
      echo "Hello, SkyPilot!"
      conda env list
    ```
  </Step>

  <Step title="Launch your project">
    Launch your project on the cluster:

    ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
    sky launch -c mycluster hello_sky.yaml
    ```
  </Step>

  <Step title="Confirm your GPU type">
    You'll see the available GPU options. Confirm your GPU type and the cluster will start spinning up.
  </Step>
</Steps>