Philippa Weather Agent

Philippa Gust is a weather and wardrobe advisor built with the OpenAI Agents SDK. She fetches local weather data and replies with clothing suggestions using regional dialects.

This repo contains the code that can be deployed on Replit and synced with GitHub for version control.

Setup

1. Install dependencies

   pip install -r requirements.txt

2. Environment variables

   • OPENAI_API_KEY – your OpenAI API key.
   • LOCATION – default city or town for the daily briefing (e.g. London).
   • BRIEFING_TIME – time of day (HH:MM, 24h) when the daily job should run. Defaults to 07:00.
   • SCHEDULE – set to true to run continuously with a daily schedule.

Running locally

python run_daily.py  # runs a single briefing

To enable daily scheduling, set SCHEDULE=true in your environment before running the script.

Replit

1. Create a new Python repl and link it with this GitHub repository.
2. Add the required secrets (OPENAI_API_KEY, LOCATION, etc.) in the Replit Secrets manager.
3. In main.py, import run_daily or run run_daily.py directly. Enable Always On or use Replit's Scheduled Tasks to trigger the script daily.

GitHub Integration

Replit can automatically push changes back to GitHub. Connect your repo under the Version Control tab and enable auto-push so that any updates (including daily briefing logs if you choose to save them) are committed.

License

This project is licensed under the MIT License. See LICENSE for details.