Skip to content
Projects

WaveSpeedAI/waverless has 634 GitHub stars and 68 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 18:50 UTC. Last push 2026-08-21.

How these counts are measured

What you can do

  • 🚀 Pull-based Architecture - Workers actively pull tasks for better load balancing
  • 🔌 RunPod Compatible - Zero-code migration from runpod-python SDK
  • ☸️ Multi-Provider - Kubernetes, Novita Serverless, Docker backends
  • 📊 Smart Autoscaling - Queue-depth, priority, and resource-aware scaling

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

High-performance serverless GPU task orchestration — the scheduling layer behind wavespeed.ai

Developer Tools

README.md

Original
WaveSpeedAI Logo

Waverless

High-performance Serverless GPU Task Orchestration System

🌐 wavespeed.ai • 📐 Architecture • 📖 User Guide • 🔧 Developer Guide


Features

  • 🚀 Pull-based Architecture - Workers actively pull tasks for better load balancing
  • 🔌 RunPod Compatible - Zero-code migration from runpod-python SDK
  • ☸️ Multi-Provider - Kubernetes, Novita Serverless, Docker backends
  • 📊 Smart Autoscaling - Queue-depth, priority, and resource-aware scaling
  • 🛡️ Graceful Shutdown - Zero task loss during rolling updates

Architecture

flowchart TB
    subgraph Clients
        direction LR
        Client[Client V1 API]
        WebUI[Web UI]
    end

    subgraph Core["Waverless API Server"]
        direction TB
        Queue[Task Queue]
        WM[Worker Mgmt]
        Autoscaler[Autoscaler]
        Store[(Redis + MySQL)]
    end

    subgraph Provider
        direction LR
        K8s[K8s]
        Novita[Novita]
        Docker[Docker]
    end

    subgraph Workers
        direction LR
        W1[Worker A]
        W2[Worker B]
        W3[Worker ...]
    end

    Clients -->|submit| Core
    Core --> Provider
    Provider -->|manage| Workers
    Workers -->|pull tasks| Core

    style Clients fill:#4a90a4,color:#fff
    style Core fill:#2d5a7b,color:#fff
    style Provider fill:#5d8aa8,color:#fff
    style Workers fill:#7fb3d3,color:#000

Quick Start

# Local development
docker-compose up -d mysql redis
cp config/config.example.yaml config/config.yaml
go run cmd/main.go

# Kubernetes deployment
./deploy.sh install

API Example

# Submit task
curl -X POST http://localhost:8090/v1/my-endpoint/run \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "hello world"}}'

# Check status
curl http://localhost:8090/v1/status/{task_id}

Documentation

Document Description
Architecture System design, components, data flow, lifecycle
User Guide Deployment, API reference, autoscaling, troubleshooting
Developer Guide Code structure, core design, provider integration

License

MIT License


WaveSpeed AI — AI image & video generation platform. Try it in the browser: Image generator · Video generator