SKypilot | Akash Network - Your Guide to Decentralized Cloud

SkyPilot is a framework for running AI and batch workloads on any infra, offering unified execution, high cost savings, and high GPU availability.

Here’s a step-by-step guide to creating a Akypilot Docker image and deploying it on Akash.

Creating the Docker Image

Step 1: Clone the Repository

Open your terminal and clone the SkyPilot repository:

git clone https://github.com/skypilot-org/skypilot.git
cd skypilot

Review the repo structure to understand what files and scripts are present:

ls -la

Step 2: Create a Dockerfile

Inside the skypilot directory, create a Dockerfile:

touch Dockerfile

Open the file in your favorite text editor and add the following instructions:

# Use an official Python image as the base
FROM python:3.10-slim

# Set the working directory
WORKDIR /app

# Copy the SkyPilot source code into the container
COPY . /app

# Install dependencies
RUN pip install --no-cache-dir -r requirements.txt

# Expose the necessary port (if applicable)
EXPOSE 8000

# Define the command to run your application
CMD ["python", "skypilot.py"]

Adjust the CMD line based on the entry point for the application.

Step 3: Build the Docker Image

Build the image using Docker:

docker build -t skypilot-app .

Verify the image is built successfully:

docker images

Step 4: Push the Docker Image to a Registry

docker login

Tag the Docker image:

docker push <your-dockerhub-username>/skypilot-app:latest

Step 5: Deploy on Akash

Prepare the SDL File

Use the SDL template below to create a deploy.yaml file:

version: "2.0"

services:
  web:
    image: <your-dockerhub-username>/skypilot-app:latest
    env:
      - PORT=8000
    expose:
      - port: 8000
        as: 80
        accept:
          - 0.0.0.0/0
        to:
          - global
profiles:
  compute:
    web:
      resources:
        cpu:
          units: 1.0
        memory:
          size: 512Mi
        storage:
          size: 1Gi
  placement:
    akash:
      attributes:
        region: us-west
      signedBy:
        anyOf:
          - "akash"
      pricing:
        web:
          denom: uakt
          amount: 100
deployment:
  web:
    akash:
      profile: web
      count: 1

Replace <your-dockerhub-username> with your actual Docker Hub username or the registry URL.

Deploy Using Akash CLI

Install the Akash CLI if you haven’t already:

curl https://raw.githubusercontent.com/ovrclk/akash/master/godownloader.sh | sh

Authenticate and fund your Akash wallet with testnet or mainnet tokens.
Create a deployment using the SDL file:

akash tx deployment create --from <your-wallet-address> --node <akash-node-url> --fees <fee>

Monitor the status of the deployment:

akash query deployment list --owner <your-wallet-address>

Access the application using the assigned endpoint once the deployment is active.