Overview
Gene-WeatherIntelligence is designed to work immediately after deployment. The four main weather tools use the free Open-Meteo API, which requires no API key, no configuration, and no sign-up. You can start checking weather data right away.
This guide covers:
- Immediate start — Using the gene with no configuration
- Finding coordinates — Getting latitude and longitude for any location
- Optional setup — Adding city-based weather search with OpenWeatherMap
- Testing — Verifying everything works
Start Immediately (No Configuration Needed)
The following tools work immediately after deployment with no API keys or configuration:
| Tool | What It Does |
|---|---|
currentWeather |
Get current weather conditions by latitude/longitude |
weatherForecast |
Get daily forecasts with highs and lows |
weatherHistory |
Get historical weather data for any date range |
severeWeatherAlerts |
Get active weather warnings and advisories |
To start using the gene:
- Deploy Gene-WeatherIntelligence to Feluda
- Get the latitude and longitude for your location
- Run
currentWeatherwith your coordinates - Run
weatherForecastto see upcoming days - Use the AI prompts for guided planning
Finding Latitude and Longitude
Open-Meteo tools require latitude and longitude coordinates. Here are simple ways to find them:
Method 1: Search Engine
- Search for:
[city name] latitude longitude - Example: "New York latitude longitude" → 40.7128, -74.0060
Method 2: Mapping Services
- Open Google Maps or any mapping service
- Right-click on the location
- Select "What's here?" or similar
- Copy the coordinates
Method 3: Online Tools
- Use a free coordinate finder service
- Enter a location name
- Get the coordinates
Common Coordinates for Reference:
| City | Latitude | Longitude |
|---|---|---|
| New York | 40.7128 | -74.0060 |
| London | 51.5074 | -0.1278 |
| Tokyo | 35.6762 | 139.6503 |
| Sydney | -33.8688 | 151.2093 |
| Paris | 48.8566 | 2.3522 |
| Berlin | 52.5200 | 13.4050 |
| Singapore | 1.3521 | 103.8198 |
| Dubai | 25.2048 | 55.2708 |
Optional: Add City-Based Weather Search
If you want to search for weather by city name instead of coordinates, you can add the OpenWeatherMap API:
Step 1: Sign Up for OpenWeatherMap
- Go to https://openweathermap.org/api
- Click "Sign Up" and create a free account
- Once logged in, navigate to your API keys
- You'll find your API key in the dashboard
- Copy the key for use in Feluda Vault
Step 2: Configure the Secret in Feluda Vault
- Open the Feluda Desktop Application
- Navigate to the Vault section
- Click "Add Secret"
- Add the following key-value pair:
| Secret Name | Value |
|---|---|
OPENWEATHER_API_KEY |
Your OpenWeatherMap API key |
- Save the secret
Step 3: Test City-Based Search
Run: tool:weatherByCity with city=London
Expected: Weather data for London
Test Your Setup
Test Without API Keys (Immediate)
-
currentWeather
- Run:
tool:currentWeatherwithlatitude=40.7128,longitude=-74.0060 - Expected: Current weather data for New York
- Run:
-
weatherForecast
- Run:
tool:weatherForecastwithlatitude=40.7128,longitude=-74.0060,days=3 - Expected: 3-day forecast for New York
- Run:
-
weatherAnalyst (Prompt)
- Run:
prompt:weatherAnalystwithlatitude=40.7128,longitude=-74.0060,depth=standard - Expected: Guided weather analysis workflow
- Run:
Test With API Keys (Optional)
weatherByCity
- Run:
tool:weatherByCitywithcity=London - Expected: Weather data for London
Troubleshooting
Tool Returns "Error: 'latitude' parameter is required"
This means you need to provide both latitude and longitude parameters.
- Check that both parameters are included
- Example:
latitude=40.7128,longitude=-74.0060
Tool Returns HTTP 404 or No Data
This can happen for:
- Invalid coordinates (check they are correct)
- Locations with limited weather station coverage
- Historical data requests outside the available range
Tool Returns "Secret Not Configured"
This only applies to weatherByCity:
- Check that you've added
OPENWEATHER_API_KEYto Vault - Verify the secret name matches exactly
- Restart Feluda after adding secrets
Next Steps
- Deploy Gene-WeatherIntelligence to Feluda
- Test
currentWeatherwith your location - Test
weatherForecastfor planning - Use the AI prompts for guided analysis
- Integrate weather intelligence into your daily workflows
- (Optional) Add OpenWeatherMap API key for city-based search
You can start using the gene immediately without any API keys. No configuration is required.
Frequently Asked Questions
- Do I need any API keys to use Gene-WeatherIntelligence?
- No. The four main weather tools (currentWeather, weatherForecast, weatherHistory, and severeWeatherAlerts) use the free Open-Meteo API and require no API key. You can start using the gene immediately after deployment. Only weatherByCity requires an optional OpenWeatherMap API key.
- How long does it take to configure Gene-WeatherIntelligence?
- Zero configuration is required to start using the gene. Just deploy it and you can immediately use the weather tools. If you want to add city-based search, it takes about 5 minutes to sign up for a free OpenWeatherMap API key.
- What are the rate limits for the free Open-Meteo API?
- Open-Meteo has generous rate limits. There are no hard caps on daily requests, but the API is designed to prevent abuse. For normal usage, you won't hit any limits. The service is production-ready and used by many applications.
- Can I use this gene for commercial purposes?
- Yes. Both Open-Meteo and OpenWeatherMap allow commercial use of their free tiers. Open-Meteo data is available under Creative Commons license. Always check each provider's terms of service for the latest details.
- How do I get latitude and longitude for a location?
- You can use any mapping service or search engine. Simply search for the location name plus "latitude longitude" to get coordinates. For example, "New York latitude longitude" returns 40.7128, -74.0060.