Create README.md

README.md

@@ -1,13 +1,35 @@
 ---
-title: Skyloom
-emoji: 😻
-colorFrom: pink
-colorTo: blue
+title: Skyloom Karachi AQI Forecaster
+emoji: 🌫️
+colorFrom: blue
+colorTo: yellow
 sdk: gradio
 sdk_version: 6.16.0
-python_version: '3.13'
 app_file: app.py
 pinned: false
+license: apache-2.0
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Skyloom: AQI Forecasting for Karachi
+
+[![Hugging Face Spaces](https://img.shields.io/badge/🤗-Spaces-yellow)](https://huggingface.co/spaces/mahwizzzz/skyloom)
+
+**Skyloom** uses a fine‑tuned TimesFM‑2.5 model to predict hourly Air Quality Index (AQI) in Karachi, Pakistan.  
+Just provide past AQI values (CSV or comma‑separated) and get a 24‑72 hour forecast with interactive visualisation.
+
+## Features
+- ✅ **Easy input**: paste values or upload CSV
+- ✅ **Custom horizon**: 1 to 72 hours ahead
+- ✅ **Interactive Plotly chart** with past vs forecast
+- ✅ **Fast inference** (runs on CPU or GPU)
+
+## Model Performance
+- **Test MAE**: 5.18
+- **Test sMAPE**: 5.46%
+- **Test MASE**: 0.4687
+
+## Citation
+If you use this Space or the underlying model, please cite the [model card](https://huggingface.co/mahwizzzz/skyloom).
+
+---
+Built with [Gradio](https://gradio.app) and [Transformers](https://huggingface.co/docs/transformers).