README.md

---
title: Kronos Forecast API
emoji: 📈
colorFrom: indigo
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
---

# Kronos Forecast API

Backend for a personal SPY/ES forecasting app. Runs the Kronos-mini foundation
model from [shiyu-coder/Kronos](https://github.com/shiyu-coder/Kronos) on CPU.

## Endpoint

`POST {space-url}/api/predict`

Body:
```json
{
  "data": ["SPY", "1h", 360, 24, 30]
}
```
Returns JSON with `history`, `forecast_mean`, `forecast_low`, `forecast_high`,
and a `metrics` object (bullish probability, expected change, vol expansion).

## Setup

The Space's Dockerfile clones the Kronos repo at build time so we can import
the `model` module. See `Dockerfile`.

⚠️ Not financial advice. Educational use only.