README.md

metadata

title: Chronos2 Forecasting API
emoji: 📊
colorFrom: blue
colorTo: green
sdk: docker
app_file: Dockerfile.spaces
app_port: 7860

Chronos2 Excel Forecasting API

Time series forecasting API powered by Amazon Chronos-2 model with Excel Add-in support.

Features

• ✅ Univariate & Multivariate Forecasting - Multiple time series support
• ✅ Anomaly Detection - Detect outliers in your data
• ✅ Backtesting - Validate forecast accuracy
• ✅ Excel Add-in - Direct integration with Microsoft Excel
• ✅ Interactive Charts - Visualize forecasts and anomalies
• ✅ REST API - Easy integration with any platform

Quick Start

API Endpoints

• Health Check: GET /health
• Documentation: GET /docs
• Univariate Forecast: POST /forecast/univariate
• Multivariate Forecast: POST /forecast/multivariate
• Anomaly Detection: POST /forecast/anomaly
• Backtesting: POST /forecast/backtest

Excel Add-in

Load the add-in in Excel:

1. Insert → Add-ins → Upload My Add-in
2. Paste URL: https://ttzzs-chronos2-excel-forecasting-api.hf.space/manifest.xml

Example API Call

curl -X POST https://ttzzs-chronos2-excel-forecasting-api.hf.space/forecast/univariate \
  -H "Content-Type: application/json" \
  -d '{
    "values": [100, 102, 105, 108, 110],
    "prediction_length": 3,
    "model_id": "amazon/chronos-2"
  }'

Architecture

Built with Clean Architecture principles:

• Domain Layer - Business logic and entities
• Application Layer - Use cases and services
• Infrastructure Layer - External dependencies (ML models, storage)
• API Layer - FastAPI routes and DTOs

Technology Stack

• Framework: FastAPI 0.115.5
• ML Model: Amazon Chronos-2 (Transformer-based forecasting)
• Python: 3.10+
• Docker: Optimized multi-stage build

License

MIT License

Support

For issues and questions, visit the GitHub repository.