README.md

---
title: Weatherhack API
emoji: 🌤️
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

# Weatherhack API & Dashboard

A zero-cost, Weatherstack-compatible API service with a beautiful testing dashboard.

## 🚀 Getting Started

This Space runs both:
1.  **FastAPI Service**: On port 8000 (accessible via `/current`, `/forecast`, etc.)
2.  **Streamlit Dashboard**: On port 7860 (the UI you see here)

### 🔑 Configuration
Set the following Secret in your Space settings:
- `WEATHERSTACK_ACCESS_KEY`: `b55a6ab9aec1ab156c0b46f0a9ef93dd` (or your preferred key)

## 📡 API Endpoints
- `/current`: Real-time weather + Air Quality
- `/forecast`: Up to 14 days forecast
- `/historical`: Weather archive
- `/autocomplete`: Location suggestions

Powered by [Open-Meteo](https://open-meteo.com) and [Nominatim](https://nominatim.org).