---
id: imgw-pib
version: "2.5.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# imgw-pib — Python wrapper for IMGW-PIB API.

License: permissive · Maintenance: active · Downloads: 88.7K/mo

## What it is and what it does

This package provides an async Python client for querying weather and hydrological data from Poland's IMGW-PIB (Institute of Meteorology and Water Management) API. It wraps the HTTP API calls using aiohttp, allowing non-blocking requests suitable for integration into async applications. The library handles API errors, network timeouts, and client errors with specific exception types.

The package is built on aiofiles, aiohttp, orjson, and yarl for efficient async I/O and JSON parsing. It targets modern Python (3.13+) and is classified as production-stable. Use it when you need to fetch current or historical weather and water-level data for Polish monitoring stations in an async context.

Use it for:

- Fetch real-time weather data from Polish meteorological stations for a weather dashboard or alert system.
- Monitor hydrological station data (water levels, flow rates) for flood prediction or water resource management.
- Integrate IMGW-PIB data into an async IoT or home automation system that queries multiple APIs concurrently.
- Build a data pipeline that periodically collects weather and hydrological observations for analysis or archival.
- Create a weather API aggregator that combines IMGW-PIB with other regional data sources.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

An async Python wrapper for the IMGW-PIB API that fetches weather and hydrological station data from Poland's Institute of Meteorology and Water Management.

Yes, if you need Polish weather or hydrological data in an async Python application. The package is actively maintained, has no known vulnerabilities, and uses a permissive license. The Python 3.13+ requirement is restrictive but intentional; verify your target environment supports it. Low install friction and a clear API make it straightforward to adopt.

## Install

pip install imgw-pib
uv add imgw-pib
poetry add imgw-pib

## Installing imgw-pib

Before you install: Low install friction with a pure-Python wheel. Active maintenance with a release 18 days ago and recent commits. Requires Python 3.13 or later, which narrows compatibility to current versions only.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

import asyncio
from aiohttp import ClientSession
from imgw_pib import ImgwPib

async def main():
    async with ClientSession() as session:
        imgwpib = await ImgwPib.create(session, weather_station_id="12200")
        weather = await imgwpib.get_weather_data()
        print(weather)

asyncio.run(main())

Requires Python 3.13 or later; requires an active aiohttp ClientSession and valid IMGW-PIB station IDs.

Verify before relying:

- Whether the package handles rate limiting or connection pooling for repeated API calls
- API availability and stability guarantees for the underlying IMGW-PIB service
- Whether station IDs are discoverable or must be known in advance

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 88.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

IMGW-PIB API wrapper, Polish weather data async, hydrological station data, async weather API client, IMGW weather wrapper, Poland meteorological data, aiohttp weather client, weather-api, async-http, poland

[View on SkillFed](https://skillfed.io/packages/imgw-pib) · [View on PyPI](https://pypi.org/project/imgw-pib/)