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.1.2

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.1.2
File	Size	Uploaded
python_weather-2.1.2.tar.gz	12.6 kB	Jan 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-weather 2.1.2
File	Interpreter	ABI	Platform	Reset
python_weather-2.1.2-py3-none-any.whl 13.7 kB Jan 23, 2026	Python 3	none	any	Details

Total release size: 26.2 kB

Release files / python_weather-2.1.2.tar.gz

Download URL	python_weather-2.1.2.tar.gz
Size	12.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`2b40f6fff32cbde16066a6cd763fe04624e9081600338c1e69f35f908560e0da`
BLAKE2b-256 checksum How to use checksums	`d394a588077a78af7968d13a3759756590a722488fa1d6d3e6e911873d651bf3`
Upload date	Jan 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

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/8ade5984f53cf7835aca4f6d2bc1baa0ff7c6186

Workflow

Publishing configuration: github.com/null8626/python-weather/blob/8ade5984f53cf7835aca4f6d2bc1baa0ff7c6186/.github/workflows/publish.yml
Publishing logs: github.com/null8626/python-weather/actions/runs/21283805526/attempts/1

Artifact

Subject: python_weather-2.1.2.tar.gz
SHA-256 checksum: 2b40f6fff32cbde16066a6cd763fe04624e9081600338c1e69f35f908560e0da Verifying attestations

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

Download URL	python_weather-2.1.2-py3-none-any.whl
Size	13.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`eaa86ac987ea589b36f9e40d65a31c247e48f7488a20c6647d237a596269718d`
BLAKE2b-256 checksum How to use checksums	`c28093f400a42b0c3d7a356428f702e6d094a3d523ac0673ce777f1334d1b1c7`
Upload date	Jan 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

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

Workflow

Publishing configuration: github.com/null8626/python-weather/blob/8ade5984f53cf7835aca4f6d2bc1baa0ff7c6186/.github/workflows/publish.yml
Publishing logs: github.com/null8626/python-weather/actions/runs/21283805526/attempts/1

Artifact

Subject: python_weather-2.1.2-py3-none-any.whl
SHA-256 checksum: eaa86ac987ea589b36f9e40d65a31c247e48f7488a20c6647d237a596269718d Verifying attestations