Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getbindu.com/llms.txt

Use this file to discover all available pages before exploring further.

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

{
  "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"
}

{
  "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