Real-time Sky Classification

Open-source ML system that classifies AllSky camera images. Detect clear skies, clouds, and precipitation automatically.

Get Started View Source

GET /api/clf ~30ms

{
  "skystate": "clear",
  "confidence": 0.9847,
  "probs": {
    "clear": 0.9847,
    "light_clouds": 0.0102,
    "heavy_clouds": 0.0038,
    "precipitation": 0.0013
  }
}

Features

⚡

Fast Inference

ONNX Runtime, under 50ms

🔌

REST API

Simple JSON endpoints

🐳

Docker Ready

One command deploy

🎯

Train Your Own

Custom models

Classifications

☀️

Clear

🌤️

Light Clouds

☁️

Heavy Clouds

🌧️

Precipitation

Quick Start

Clone & configure

git clone https://github.com/SkyClf/skyclf.git
cd skyclf
# Edit docker-compose.yml with your AllSky URL

Run with Docker

docker compose up -d

Get predictions

curl http://localhost:8080/api/clf

API

Endpoint	Description
`GET /api/clf`	Simple classification result
`GET /api/latest`	Full image details + prediction
`GET /latest.jpg`	Latest camera image
`GET /health`	Health check