https://github.com/kayhendriksen/foehn
Download MeteoSwiss Open Government Data — weather stations, radar, hail, forecasts and climate series — via Python API, CLI, or MCP server, as DataFrames or Parquet files
https://github.com/kayhendriksen/foehn
climate databricks meteoswiss open-data polars python weather
Last synced: about 23 hours ago
JSON representation
Download MeteoSwiss Open Government Data — weather stations, radar, hail, forecasts and climate series — via Python API, CLI, or MCP server, as DataFrames or Parquet files
- Host: GitHub
- URL: https://github.com/kayhendriksen/foehn
- Owner: kayhendriksen
- License: mit
- Created: 2026-03-18T21:37:28.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-18T14:01:34.000Z (8 days ago)
- Last Synced: 2026-04-18T16:02:31.161Z (8 days ago)
- Topics: climate, databricks, meteoswiss, open-data, polars, python, weather
- Language: Python
- Homepage:
- Size: 2.48 MB
- Stars: 35
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
MeteoSwiss Open Data — Python API, CLI, MCP server, Parquet & Delta tables
---
foehn downloads every [MeteoSwiss OGD](https://github.com/MeteoSwiss/opendata) collection via the STAC API, converts CSV/TXT to Parquet with [Polars](https://pola.rs), and optionally ingests everything into [Databricks](https://www.databricks.com) Unity Catalog Delta tables on a daily schedule. It also ships an [MCP server](https://modelcontextprotocol.io) so LLMs can query Swiss weather data directly.
Daily weather in Bern, powered by foehn's MCP server and MeteoSwiss open data.
## Why foehn?
- **20+ collections in one command** — weather stations, radar, hail maps, forecasts, climate scenarios, and more
- **MCP server for LLMs** — give your favorite LLM live access to MeteoSwiss data with the MCP server
- **Significantly smaller on disk** — columnar Parquet with Zstandard compression vs. raw CSVs
- **Incremental by default** — only re-downloads files that changed since your last run, tracked via `_last_run.json`
- **No Spark required locally** — download + conversion uses Polars only; Spark is optional for Delta ingestion
- **Ships a Declarative Automation Bundle** — ready-to-deploy daily job and historical backfill, no pipeline config needed
---
## Quick start
```bash
pip install foehn
foehn download
```
Recent data (Jan 1 to yesterday) is downloaded and converted to Parquet under `./data/meteoswiss/`.
---
## Installation
**From PyPI:**
```bash
pip install foehn
```
**From source:**
```bash
git clone https://github.com/kayhendriksen/foehn
cd foehn
pip install -e .
```
**With extras:**
```bash
pip install "foehn[databricks]" # PySpark + Delta
pip install "foehn[mcp]" # MCP server
```
Requires Python 3.10 or later.
---
## Python API
```python
import foehn
df = foehn.load("smn", station="BER", frequency="d")
```
Load data directly into Polars DataFrames, explore metadata, download to disk, and convert to Parquet — all from Python. See the [full Python API documentation](docs/python-api.md).
---
## CLI
```bash
foehn download smn pollen
foehn load smn --station BER --frequency d
```
The CLI mirrors the Python API with subcommands for downloading, converting, loading, and inspecting metadata. See the [full CLI documentation](docs/cli.md).
---
## MCP server
```json
{
"mcpServers": {
"foehn": {
"command": "foehn",
"args": ["mcp"]
}
}
}
```
Give any MCP-compatible LLM live access to MeteoSwiss data. See the [full MCP server documentation](docs/mcp-server.md).
---
## Documentation
| | |
|---|---|
| [Collections](docs/collections.md) | All 20+ MeteoSwiss datasets, categories, and time slice conventions |
| [Python API](docs/python-api.md) | Loading data, metadata, downloading, and Parquet conversion |
| [CLI](docs/cli.md) | All subcommands, flags, and environment variables |
| [MCP Server](docs/mcp-server.md) | Setup, configuration, and available tools |
| [Databricks Pipeline](docs/databricks.md) | Declarative Automation Bundle deployment |
---
## Data sources
| | |
|---|---|
| STAC API | https://data.geo.admin.ch/api/stac/v1 |
| Documentation | https://opendatadocs.meteoswiss.ch |
| MeteoSwiss OGD | https://github.com/MeteoSwiss/opendata |
---
## License
MIT