python-weather

A free and asynchronous weather Python API wrapper made in Python, for Python.

Getting started

Run the following command in your terminal:

pip install python-weather

Example

For more information, please read the documentation.

# Import the module.
import python_weather

import asyncio


async def main() -> None:
  
  # Declare the client. The measuring unit used defaults to the metric system (celcius, km/h, etc.)
  async with python_weather.Client(unit=python_weather.IMPERIAL) as client:
    
    # Fetch a weather forecast from a city.
    weather = await client.get('New York')
    
    # Fetch the temperature for today.
    print(weather.temperature)
    
    # Fetch weather forecast for upcoming days.
    for daily in weather:
      print(daily)
    
      # Each daily forecast has their own hourly forecasts.
      for hourly in daily:
        print(f' --> {hourly!r}')

if __name__ == '__main__':
  asyncio.run(main())

Data source

This library depends on wttr.in, which uses data from the World Weather Online API.

Donations

If you want to support this project, consider donating! ❤

Metadata

Release files for python-weather 2.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 python-weather 2.2.1
File	Size	Uploaded
python_weather-2.2.1.tar.gz	12.9 kB	Apr 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-weather 2.2.1
File	Interpreter	ABI	Platform	Reset
python_weather-2.2.1-py3-none-any.whl 13.9 kB Apr 29, 2026	Python 3	none	any	Details

Total release size: 26.9 kB

Release files / python_weather-2.2.1.tar.gz

Download URL	python_weather-2.2.1.tar.gz
Size	12.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`528725c2110bca4f53c9205d119a95a40c259dd6f9604060766dc2f6927c76fd`
BLAKE2b-256 checksum How to use checksums	`de6ad21f3c4d86984d5a740a9f850dd867fc19d5e0030af8583ece075d7935d9`
Upload date	Apr 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/null8626/python-weather
Publishing commit: github.com/null8626/python-weather/tree/94dff6d02e3c426cd7eab4f546db765399c0de4e

Workflow

Publishing configuration: github.com/null8626/python-weather/blob/94dff6d02e3c426cd7eab4f546db765399c0de4e/.github/workflows/publish.yml
Publishing logs: github.com/null8626/python-weather/actions/runs/25117944341/attempts/1

Artifact

Subject: python_weather-2.2.1.tar.gz
SHA-256 checksum: 528725c2110bca4f53c9205d119a95a40c259dd6f9604060766dc2f6927c76fd Verifying attestations

Release files / python_weather-2.2.1-py3-none-any.whl

Download URL	python_weather-2.2.1-py3-none-any.whl
Size	13.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`600a4487327245ce91468709d8ab94c9130ccae340fc61ed5e1994260927742a`
BLAKE2b-256 checksum How to use checksums	`34e70db698ba1d8564a71576efb7223bd9c0be4f0b4ae192164ab1aea7507b72`
Upload date	Apr 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/null8626/python-weather
Publishing commit: github.com/null8626/python-weather/tree/94dff6d02e3c426cd7eab4f546db765399c0de4e

Workflow

Publishing configuration: github.com/null8626/python-weather/blob/94dff6d02e3c426cd7eab4f546db765399c0de4e/.github/workflows/publish.yml
Publishing logs: github.com/null8626/python-weather/actions/runs/25117944341/attempts/1

Artifact

Subject: python_weather-2.2.1-py3-none-any.whl
SHA-256 checksum: 600a4487327245ce91468709d8ab94c9130ccae340fc61ed5e1994260927742a Verifying attestations