Weather

Get weather data and forecasts

The Weather tool lets an agent fetch current conditions, forecasts, and air-quality data.

Overview

Weather tool provides current weather, forecasts, and air quality data using various weather APIs.

Installation

pip install "praisonai[tools]"

Environment Variables

export OPENWEATHER_API_KEY="${OPENWEATHER_API_KEY:?Set OPENWEATHER_API_KEY in your shell}"
# Or
export WEATHERAPI_KEY="${WEATHERAPI_KEY:?Set WEATHERAPI_KEY in your shell}"

Quick Start

1. Simple Usage

   from praisonai_tools import WeatherTool
   
   # Initialize
   weather = WeatherTool()
   
   # Get weather
   result = weather.get_weather("London")
   print(result)
   
2. With Configuration

   Use the same tool with an agent — see Usage with Agent below, or pass env vars and options from the sections above.

How It Works

Usage with Agent

from praisonaiagents import Agent
from praisonai_tools import WeatherTool

agent = Agent(
    name="WeatherBot",
    instructions="You provide weather information.",
    tools=[WeatherTool()]
)

response = agent.chat("What's the weather in New York?")
print(response)

Available Methods

get_weather(location)

Get current weather.

from praisonai_tools import WeatherTool

weather = WeatherTool()
result = weather.get_weather("San Francisco")

get_forecast(location, days=3)

Get weather forecast.

forecast = weather.get_forecast("Tokyo", days=5)

get_air_quality(location)

Get air quality index.

aqi = weather.get_air_quality("Beijing")

Common Errors

Error	Cause	Solution
API key not configured	Missing key	Set environment variable
City not found	Invalid location	Check city name

Best Practices

Keep the weather API key in the environment

Set OPENWEATHER_API_KEY or WEATHERAPI_KEY in your shell or .env. WeatherTool() reads it automatically — never hard-code the key.

Bound forecast length

get_forecast(location, days=3) defaults to 3 days. Request only the horizon the task needs to keep responses concise.

Handle unknown locations

Invalid city names return a “City not found” error. Wrap the call in try/except so the agent can ask the user to clarify the location.

Related Tools

Google Maps

Location services