Problem statement
The repo has PDF summarisers, RAG agents, payment agents, and flight trackers
— but no simple real-world data monitoring example that a complete beginner
can run in under 5 minutes. New contributors and students learning uAgents
need a minimal, free-API example that demonstrates the chat protocol +
external REST API integration without any cost barrier or complex setup.
Proposed solution
Add a Real-time Weather Monitoring Agent under contributors/weather-monitor-agent/
The agent will:
- Accept a city name as input via uAgents chat protocol
- Fetch live weather data from OpenWeatherMap API (free tier, no credit card)
- Return temperature, humidity, wind speed, and weather condition
- Alert the user if temperature crosses a configurable threshold
- Register on Agentverse and respond via chat protocol
Folder structure:
contributors/weather-monitor-agent/
├── README.md
├── requirements.txt
├── .env.example # OPENWEATHER_API_KEY, AGENTVERSE_API_KEY
├── agent.py # uAgent with weather fetch + chat protocol
└── assets/
└── demo.png
Scope and impact
- New folder:
contributors/weather-monitor-agent/
- Update:
contributors/CHANGELOG.md
- No existing examples affected
- Fills a gap in the "Getting Started" category —
currently no beginner real-time API monitoring example exists
Alternatives considered (optional)
Using a paid weather API like WeatherAPI or Tomorrow.io — rejected because
OpenWeatherMap free tier requires no credit card and works instantly,
keeping the barrier to entry at zero for all contributors.
Additional context (optional)
I am a GSSoC '26 contributor with Python experience.
Tech stack: uagents, httpx, python-dotenv, OpenWeatherMap API (free tier)
I will implement this fully and submit a PR within 3 days of approval.
Contributor checklist:
- I will place the agent under
contributors/weather-monitor-agent/ only
- I will update
contributors/CHANGELOG.md
- I have starred this repository
Problem statement
The repo has PDF summarisers, RAG agents, payment agents, and flight trackers
— but no simple real-world data monitoring example that a complete beginner
can run in under 5 minutes. New contributors and students learning uAgents
need a minimal, free-API example that demonstrates the chat protocol +
external REST API integration without any cost barrier or complex setup.
Proposed solution
Add a Real-time Weather Monitoring Agent under
contributors/weather-monitor-agent/The agent will:
Folder structure:
contributors/weather-monitor-agent/
├── README.md
├── requirements.txt
├── .env.example # OPENWEATHER_API_KEY, AGENTVERSE_API_KEY
├── agent.py # uAgent with weather fetch + chat protocol
└── assets/
└── demo.png
Scope and impact
contributors/weather-monitor-agent/contributors/CHANGELOG.mdcurrently no beginner real-time API monitoring example exists
Alternatives considered (optional)
Using a paid weather API like WeatherAPI or Tomorrow.io — rejected because
OpenWeatherMap free tier requires no credit card and works instantly,
keeping the barrier to entry at zero for all contributors.
Additional context (optional)
I am a GSSoC '26 contributor with Python experience.
Tech stack: uagents, httpx, python-dotenv, OpenWeatherMap API (free tier)
I will implement this fully and submit a PR within 3 days of approval.
Contributor checklist:
contributors/weather-monitor-agent/onlycontributors/CHANGELOG.md