skypilot: A Python repository from victorv

SkyPilot

Run LLMs and AI on Any Cloud

🔥 News 🔥

[Jun, 2024] Reproduce GPT with llm.c on any cloud: guide
[Apr, 2024] Serve and finetune Llama 3 on any cloud or Kubernetes: example
[Apr, 2024] Serve Qwen-110B on your infra: example
[Apr, 2024] Using Ollama to deploy quantized LLMs on CPUs and GPUs: example
[Feb, 2024] Deploying and scaling Gemma with SkyServe: example
[Feb, 2024] Serving Code Llama 70B with vLLM and SkyServe: example
[Dec, 2023] Mixtral 8x7B, a high quality sparse mixture-of-experts model, was released by Mistral AI! Deploy via SkyPilot on any cloud: example
[Nov, 2023] Using Axolotl to finetune Mistral 7B on the cloud (on-demand and spot): example
[Sep, 2023] Case study: Covariant transformed AI development on the cloud using SkyPilot, delivering models 4x faster cost-effectively: read the case study
[Aug, 2023] Finetuning Cookbook: Finetuning Llama 2 in your own cloud environment, privately: example, blog post
[June, 2023] Serving LLM 24x Faster On the Cloud with vLLM and SkyPilot: example, blog post

Archived

[Mar, 2024] Serve and deploy Databricks DBRX on your infra: example
[Feb, 2024] Speed up your LLM deployments with SGLang for 5x throughput on SkyServe: example
[Dec, 2023] Using LoRAX to serve 1000s of finetuned LLMs on a single instance in the cloud: example
[Sep, 2023] Mistral 7B, a high-quality open LLM, was released! Deploy via SkyPilot on any cloud: Mistral docs
[July, 2023] Self-Hosted Llama-2 Chatbot on Any Cloud: example
[April, 2023] SkyPilot YAMLs for finetuning & serving the Vicuna LLM with a single command!

SkyPilot is a framework for running LLMs, AI, and batch jobs on any cloud, offering maximum cost savings, highest GPU availability, and managed execution.

SkyPilot abstracts away cloud infra burdens:

Launch jobs & clusters on any cloud
Easy scale-out: queue and run many jobs, automatically managed
Easy access to object stores (S3, GCS, R2)

SkyPilot maximizes GPU availability for your jobs:

Provision in all zones/regions/clouds you have access to (the Sky), with automatic failover

SkyPilot cuts your cloud costs:

Managed Spot: 3-6x cost savings using spot VMs, with auto-recovery from preemptions
Optimizer: 2x cost savings by auto-picking the cheapest VM/zone/region/cloud
Autostop: hands-free cleanup of idle clusters

SkyPilot supports your existing GPU, TPU, and CPU workloads, with no code changes.

Install with pip (we recommend the nightly build for the latest features or from source):

pip install "skypilot-nightly[aws,gcp,azure,oci,lambda,runpod,fluidstack,paperspace,cudo,ibm,scp,kubernetes]"  # choose your clouds

To get the last release, use:

pip install -U "skypilot[aws,gcp,azure,oci,lambda,runpod,fluidstack,paperspace,cudo,ibm,scp,kubernetes]"  # choose your clouds

Current supported providers (AWS, Azure, GCP, OCI, Lambda Cloud, RunPod, Fluidstack, Paperspace, Cudo, IBM, Samsung, Cloudflare, any Kubernetes cluster):

SkyPilot

Getting Started

You can find our documentation here.

SkyPilot in 1 Minute

A SkyPilot task specifies: resource requirements, data to be synced, setup commands, and the task commands.

Once written in this unified interface (YAML or Python API), the task can be launched on any available cloud. This avoids vendor lock-in, and allows easily moving jobs to a different provider.

Paste the following into a file my_task.yaml:

resources:
  accelerators: V100:1  # 1x NVIDIA V100 GPU

num_nodes: 1  # Number of VMs to launch

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

# Commands to be run before executing the job.
# Typical use: pip install -r requirements.txt, git clone, etc.
setup: |
  pip install "torch<2.2" torchvision --index-url https://download.pytorch.org/whl/cu121

# Commands to run as a job.
# Typical use: launch the main program.
run: |
  cd mnist
  python main.py --epochs 1

Prepare the workdir by cloning:

git clone https://github.com/pytorch/examples.git ~/torch_examples

Launch with sky launch (note: access to GPU instances is needed for this example):

sky launch my_task.yaml

SkyPilot then performs the heavy-lifting for you, including:

Find the lowest priced VM instance type across different clouds
Provision the VM, with auto-failover if the cloud returned capacity errors
Sync the local workdir to the VM
Run the task's setup commands to prepare the VM for running the task
Run the task's run commands

Refer to Quickstart to get started with SkyPilot.

More Information

To learn more, see our Documentation and Tutorials.

Runnable examples:

LLMs on SkyPilot
- GPT-2 via llm.c
- Llama 3
- Qwen
- Databricks DBRX
- Gemma
- Mixtral 8x7B; Mistral 7B (from official Mistral team)
- Code Llama
- vLLM: Serving LLM 24x Faster On the Cloud (from official vLLM team)
- SGLang: Fast and Expressive LLM Serving On the Cloud (from official SGLang team)
- Vicuna chatbots: Training & Serving (from official Vicuna team)
- Train your own Vicuna on Llama-2
- Self-Hosted Llama-2 Chatbot
- Ollama: Quantized LLMs on CPUs
- LoRAX
- QLoRA
- LLaMA-LoRA-Tuner
- Tabby: Self-hosted AI coding assistant
- LocalGPT
- Falcon
- Add yours here & see more in llm/!
Framework examples: PyTorch DDP, DeepSpeed, JAX/Flax on TPU, Stable Diffusion, Detectron2, Distributed TensorFlow, Ray Train, NeMo, programmatic grid search, Docker, Cog, Unsloth, Ollama, llm.c and many more (examples/).

Follow updates:

Read the research:

SkyPilot paper and talk (NSDI 2023)
Sky Computing whitepaper
Sky Computing vision paper (HotOS 2021)
Policy for Managed Spot Jobs (NSDI 2024)

Support and Questions

We are excited to hear your feedback!

For issues and feature requests, please open a GitHub issue.
For questions, please use GitHub Discussions.

For general discussions, join us on the SkyPilot Slack.

Contributing

We welcome and value all contributions to the project! Please refer to CONTRIBUTING for how to get involved.

victorv/skypilot