Skip to main content

Graupel

A customizable desktop meteogram application for alpine weather forecasting.

PyPI Python License Open-Meteo Maptoolkit MapLibre OpenStreetMap

Graupel creates detailed, customizable meteograms by combining multiple numerical weather prediction models into continuous forecast chains.

Designed with alpine weather in mind, it provides detailed views of temperature, precipitation, wind, cloud structure, and other meteorological parameters while allowing different forecast models to be used for short-, medium-, and long-range forecasts.

Weather forecasts are provided through Open-Meteo. Interactive maps use Maptoolkit and MapLibre with map data from OpenStreetMap.

Features

  • Normal mode: pick a location, get a good meteogram; the model chain is chosen automatically for the region
  • Power mode: custom model chains for short-, medium-, and long-range forecasts, with Auto as a starting point
  • About 50 numerical weather prediction models from Open-Meteo
  • Detailed alpine meteograms with a vertical cloud profile
  • Temperature, precipitation and snow, wind, cloud, CAPE/CIN and other weather parameters
  • Configurable meteogram layouts (power mode)
  • Interactive time-range zoom and day ranges (4/7/10/14 days)
  • Interactive maps for picking a location
  • Copy the meteogram as a PNG image
  • Optional local forecast archive with a viewer for past forecasts (power mode)
  • Local desktop application with local configuration storage

Graupel

Graupel is a desktop application to visualize freely available weather data from OpenMeteo as a meteogram, e.g. a graph with a timeframe on the x axis and weather-realted quantities such as temperature or precipitation on the y axis.

Graupel lets you select weather models of your choice, if available through the api. You can then choose the best local model for your forecast area.

It is free to use and open source. Project-authored React frontend code is licensed under the Mozilla Public License 2.0 (MPL-2.0). All other project-owned material—including Python code and icons—is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). Bundled third-party components retain their respective licenses. See LICENSE for the exact file-level boundary and complete notices.

Installation

Windows

No clue what uv is

If you do not know what uv is, it is probably not installed. Copy the following command:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install graupel

Now open a powershell by pressing WinKey + R typing powershell and hitting Enter. Paste the copied command and execute it with a press of Enter.

After the installation of uv, start Graupel by typing

graupel

and hitting Enter. A startmenu item will be automatically created on the first run.

uv is already installed

Install graupel via

uv tool install graupel

Afterwards you can run Graupel from the terminal via

graupel

Linux

Install uv, a package manager for python, via your distros package manager. Install graupel via

uv tool install graupel

Afterwards you can run Graupel from the terminal via

graupel

Mac OS X

Install uv via homebrew:

brew install uv

or directly, if you do not have homebrew installed:

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your terminal and install Graupel:

uv tool install graupel

Afterwards you can run Graupel from the terminal via

graupel

Usage

Introduction to Weather models

Weather models are forecast algorithms that ingest a lot of sensor data and predict the configuration of the atmosphere within the forecast horizon.

Weather models have different spatial resolution (dividing the forecast area into smaller or larger rectangles), which makes a difference on how detailed geographic features, especially mountains, influence the weather physics within the model.

A higher resolution usually means more computing effort, why usually higher resolution models have lower forecast horizion. Also the atmosphere is a "chaotic" system, meaning small changes in state can have a butterfly effect the further you go in the prediction, therefore falsely assumed precision in longer forecast models may not value the outcome

Graupel allows you to "stack" weather models on top of each other, e.g. in a chain of models starting with a high resolution, but short horizon model, followed by one ore more less precise but longer horizon models. You can therefore create meteograms with a very long forecast horizon.

The longest models have a horizon of more than 14 days, giving you an effective visual forecast of two weeks. Be aware though, that usually a prediction of longer than a week can have a big uncertainty and should merely be seen as a trend.

Normal and power mode

Graupel has two modes. The Power mode switch in the header (next to the logo) changes between them at any time; switching never deletes configurations, layouts or archived forecasts.

  • Normal mode (default for new installations): choose a location and you get a meteogram. Graupel picks the region of the location and a suitable chain of weather models for it; the header shows the region and the chain as text. Models without data at the location are skipped and the next model takes over.
  • Power mode: everything for tuning the forecast. You select one of your saved configurations (or Auto, the chain normal mode would use), see the model chain cards above the meteogram, can drag the boundaries between models, and open the Config pane and the History of archived forecasts.

Installations upgraded from 0.1.x with own configurations start in power mode once; your configurations are kept and a backup of the old database is written next to it (meteogram.db.0.1.0.bak).

Meteo pane

Header

  1. The configuration selectbox (power mode) or the region and model chain (normal mode).
  2. The location selector on the right. Click inside the textbox and begin typing the name of a place; an autocomplete shows matching places. The arrow next to the textbox lists the places you used most. Alternatively click on the small map to open it in fullscreen and select a location there.

After selecting a location you will see its coordinates and height above sea level below the textbox. Selecting a new location or configuration reloads the meteogram; the refresh button next to the textbox forces a reload.

Body

  1. In power mode: the model chain for the basic meteo data and the model chain for the cloud profile, as cards with run time, usable hours and resolution. Drag the boundary between two cards to change which model covers which hours (only for the current session).
  2. The meteogram itself. Hover to see the values, use the mouse wheel to zoom the time axis, or the buttons 4/7/10/14/All to pick a day range.

Config pane (power mode)

  • Basic: the data folder (where the database lives) and the forecast archive: off by default, or kept for 7, 30, 90 or 365 days or forever.
  • Model chains: your configurations. Each has a name, its own location, a layout and two model chains: one for the basic meteo data (temperature, precipitation, wind) and one for the detailed height profile of clouds, because the best models for meteo data do not always offer a cloud profile. "Start from auto configuration" fills the chains with the automatic chain of a region. Changes are saved automatically.
  • Meteogram: the layout library. A layout defines the drawing areas of the meteogram and which quantities they show; edit it with a live preview.

Share forecast

Click the copy button at the meteogram to copy it as a PNG image to the clipboard, then paste it into an email or a messenger app. The image contains the location and the time it was created.

Metadata

Release files for graupel 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for graupel 0.2.1
File Size Uploaded Provenance Actions
graupel-0.2.1.tar.gz 3.9 MB With provenance Details for graupel-0.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for graupel 0.2.1
File Interpreter ABI Platform Actions
graupel-0.2.1-py3-none-any.whl Python 3 none any Details for graupel-0.2.1-py3-none-any.whl

Total release size: 6.5 MB

Release files / graupel-0.2.1.tar.gz

Download URL graupel-0.2.1.tar.gz
Size 3.9 MB
Tags Source
SHA-256 checksum
How to use checksums
779282d2831bdc80f9450bdde88d1d261e311db7a75e56b251917b192a6d71c5
BLAKE2b-256 checksum
How to use checksums
1f97c92c59b20594a5483588a40ecdf808e2a942c54cc2c3ad43de0d5f55aecf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Release files / graupel-0.2.1-py3-none-any.whl

Download URL graupel-0.2.1-py3-none-any.whl
Size 2.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d84bb0fd5c3a567744348a622e2c77ead0bd7013fffa316f9e3394c1bcbf1ce8
BLAKE2b-256 checksum
How to use checksums
836ee1715e076b28436d4c1c50420dfaf2c400b5797373d73a58637e8fc228d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Security for graupel 0.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for graupel-0.2.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page