Skip to main content

Library for fetching weather information from Finnish Meteorological Institute (FMI)

Project description

Test Last commit Latest version in GitHub Latest version in PyPi

Finnish Meteorological Institute Weather

Library for fetching weather information from Finnish Meteorological Institute (FMI).

Originally build for personal use because I wanted to create FMI integration for Home Assistant.

BETA WARNING! This is still under heavy development. The public API is not frozen yet so DO NOT consider it to be stable. Any version can have breaking changes.

How to use

Working example can be found in


$ pip install fmi-weather-client 

Get weather and forecasts

import fmi_weather_client

weather1 = fmi_weather_client.weather_by_coordinates(60.170998, 24.941325)
weather2 = fmi_weather_client.weather_by_place_name("Rastila, Helsinki")
forecast1 = fmi_weather_client.forecast_by_place_name("Jäppilä, Pieksämäki")
forecast2 = fmi_weather_client.forecast_by_coordinates(67.6894, 28.62406, timestep_hours=12)

There are also asynchronous versions available:

weather1 = await fmi_weather_client.async_weather_by_coordinates(60.170998, 24.941325)
weather2 = await fmi_weather_client.async_weather_by_place_name("Rastila, Helsinki")
forecast1 = await fmi_weather_client.async_forecast_by_place_name("Jäppilä, Pieksämäki")
forecast2 = await fmi_weather_client.async_forecast_by_coordinates(67.6894, 28.62406, timestep_hours=12)

If data is not available, the following exception is thrown:


Weather data

FMI provides the following commonly used information:

  • Temperature (°C)
  • Pressure (hPa)
  • Humidity (%)
  • Wind direction (°)
  • Wind speed (m/s)
  • Wind gust (m/s)
  • Dew point (°)
  • Cloud coverage (%)
  • Precipitation intensity (mm/h)
  • Symbol Documentation in Finnish

There are also other information available. Check and FMI documentation for more info.



Create and activate a virtual environment

$ python -m venv venv
$ source venv/bin/activate

Install required packages

$ make setup-dev-env

Deactivate virtual environment when you are done

$ deactivate

Run tests

This will run unit tests and code quality checks

$ make test

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fmi-weather-client-0.0.10.tar.gz (8.7 kB view hashes)

Uploaded Source

Built Distribution

fmi_weather_client-0.0.10-py3-none-any.whl (22.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page