Bindu - A2A Protocol Compliant AI Agent Framework

Weather intelligence agent providing real-time weather data and forecasts.

Code

Create weather-research.py with the code below, or save it directly from your editor.

import os
from dotenv import load_dotenv
from bindu.penguin.bindufy import bindufy
from agno.agent import Agent
from agno.tools.duckduckgo import DuckDuckGoTools
from agno.models.openrouter import OpenRouter

load_dotenv()

agent = Agent(
    instructions="You are a weather research assistant. When asked about weather, provide a clear, concise weather report with current conditions, temperature, and forecast. Focus on the most relevant information and present it in an organized, easy-to-read format. Avoid showing multiple search results - synthesize the information into a single coherent response.",
    model=OpenRouter(
        id="openai/gpt-oss-120b",
        api_key=os.getenv("OPENROUTER_API_KEY")
    ),
    tools=[DuckDuckGoTools()],
)

config = {
    "author": "bindu.builder@getbindu.com",
    "name": "weather_research_agent",
    "description": "Research agent that finds current weather and forecasts for any city worldwide",
    "deployment": {
        "url": "http://localhost:3773",
        "expose": True,
        "cors_origins": ["http://localhost:5173"]
    },
    "skills": ["skills/weather-research-skill"],
}

def handler(messages: list[dict[str, str]]):
    if messages:
        latest_message = messages[-1].get('content', '') if isinstance(messages[-1], dict) else str(messages[-1])
        result = agent.run(input=latest_message)
        
        if hasattr(result, 'content'):
            return result.content
        elif hasattr(result, 'response'):
            return result.response
        else:
            return str(result)
    
    return "Please provide a location for weather information."

bindufy(config, handler)

#bindufy(config, handler, launch=True)
# This will create a tunnel to your agent and expose it on port 3773

Skill Configuration

Create skills/weather-research-skill/skill.yaml:

# Weather Research Skill
# Advanced weather research with comprehensive meteorological analysis

id: weather-research-skill
name: weather-research-skill
version: 1.0.0
author: bindu.builder@getbindu.com

description: |
  Advanced weather research skill that provides comprehensive weather information,
  forecasts, and meteorological analysis for any location worldwide.

  Features:
  - Real-time weather data via search
  - Multi-day forecasting with confidence levels
  - Historical weather pattern analysis
  - Travel recommendations based on weather
  - Severe weather alerts
  - Climate information and trends

  Uses DuckDuckGo search to find current weather conditions
  and provides detailed analysis with both metric and imperial units.
tags:
  - weather
  - forecast
  - meteorology
  - research
  - climate
  - travel
input_modes:
  - application/json
output_modes:
  - application/json
examples:
  - "Get current weather conditions for New York City"
  - "Provide 5-day weather forecast for London"
  - "Analyze weather patterns for Tokyo"
  - "What's the weather like in Dehradun?"
  - "Give travel recommendations for Paris this weekend"
capabilities_detail:
  weather_research:
    supported: true
    description: "Comprehensive weather research and forecasting capabilities"
  search_integration:
    supported: true
    description: "Real-time weather data search via DuckDuckGo"
  forecasting:
    supported: true
    description: "Multi-day weather forecasts with confidence levels"
  analysis:
    supported: true
    description: "Weather pattern analysis and trends"

How It Works

Weather Instructions

Clear directive: “Provide clear, concise weather report”
Synthesizes information from multiple sources
Organized, easy-to-read format
Avoids raw search results

Handler

Extracts latest message content
Handles different message formats
Returns clean response (content, response, or string)
Fallback message if no location provided

Tools

DuckDuckGoTools(): Real-time web search
Searches for current weather data
Finds forecasts for any location worldwide

Model

openai/gpt-oss-120b: Advanced reasoning
Synthesizes multiple search results
Formats weather data clearly

Dependencies

uv init
uv add bindu agno python-dotenv

Environment Setup

Create .env file:

OPENROUTER_API_KEY=your_openrouter_api_key_here

Run

uv run weather-research.py

Examples:

“What’s the weather like in New York City?”
“Check the weather forecast for London this weekend”
“What’s the temperature in Tokyo right now?”

Example API Calls

Message Send Request

{
  "jsonrpc": "2.0",
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "kind": "message",
      "messageId": "9f11c870-5616-49ad-b187-d93cbb100001",
      "contextId": "9f11c870-5616-49ad-b187-d93cbb100002",
      "taskId": "9f11c870-5616-49ad-b187-d93cbb100003",
      "parts": [
        {
          "kind": "text",
          "text": "What's the weather like in New York City?"
        }
      ]
    },
     "skillId": "weather-research-skill",
    "configuration": {
      "acceptedOutputModes": ["application/json"]
    }
  },
  "id": "9f11c870-5616-49ad-b187-d93cbb100003"
}

Task get Request

{
  "jsonrpc": "2.0",
  "method": "tasks/get",
  "params": {
    "taskId": "9f11c870-5616-49ad-b187-d93cbb100003"
  },
  "id": "9f11c870-5616-49ad-b187-d93cbb100004"
}

Frontend Setup

# Clone the Bindu repository
git clone https://github.com/GetBindu/Bindu

# Navigate to frontend directory
cd frontend

# Install dependencies
npm install

# Start frontend development server
npm run dev

Open http://localhost:5173 and try to chat with the weather research agent

Beginner

Specialized

Advanced

2.2 Weather Research

Code

Skill Configuration

How It Works

Dependencies

Environment Setup

Run

Example API Calls

Frontend Setup

​Code

​Skill Configuration

​How It Works

​Dependencies

​Environment Setup

​Run

​Example API Calls

​Frontend Setup

Code

Skill Configuration

How It Works

Dependencies

Environment Setup

Run

Example API Calls

Frontend Setup