mugilu

The open sky of India, one coordinate at a time. Air quality, heat, rain, fog, smoke, UV and official warnings for any place in India, as a web page, an API and an MCP server for AI assistants.

ಮುಗಿಲು (mugilu) is Kannada for cloud or sky. It is the third tool in a small commons, alongside bharatlas (open geo data for India) and mdshare. Live at mugilu.live.

[!IMPORTANT] mugilu is informational and educational only. It is not for medical, emergency or safety-critical decisions, and there is no warranty or accuracy guarantee. For official hazard warnings, NDMA and IMD are the authoritative channels.

Contents

• What it does
• Features
• Screenshots
• Use it on the web or as an API
• Use it from an AI assistant (MCP)
• Data sources and attribution
• How it works
• Project layout
• Development
• Deploy
• Contributing
• Principles
• Licence

What it does

Give mugilu a place in India (a name in any script, or a lat,lon) and it tells you what the sky is doing to you right now. Air apps show air, weather apps show weather, and the government's own data sits in separate apps that do not talk to each other. mugilu puts these into one location-addressable layer for India.

Readings are current, not a forecast. They recompute on a cycle of about 15 minutes.

Features

• Conditions at any point. Air quality from real ground stations (modelled where no station is within 50 km, and labelled so), heat with feels-like and wet-bulb, today's high against the 1991-2020 normal, cold, rain, UV, dust, wind, fog and visibility, fire and crop-burn smoke, and active official warnings.
• Readings against their limits. Each reading is drawn against the limits it is judged by (for example the CPCB limit for each pollutant), in the order that matters to you now.
• Ambient read. One line that names the single worst hazard for you and what to do about it.
• Weighted for who is asking. Pass a persona (asthma, older adults, children, outdoor workers, heart condition) and the Ambient read is weighted for that group.
• Health impact. Years of life lost from the air, using the AQLI methodology.
• India now. A national map and leaderboard of the worst-air, hottest and dustiest places.
• Many formats. HTML for people, JSON for apps, Markdown for LLMs, a timestamped PNG, an embeddable card, a self-refreshing display for a wall screen, and an MCP server for agents.
• Three languages. English, Hindi and Kannada pages; place search accepts native scripts (ಬೆಂಗಳೂರು, दिल्ली, சென்னை).
• Installable web app. It keeps the last reading of places you opened for offline use, refreshes itself when it comes back on screen, and can send opt-in alerts for official warnings at a place.
• Plain HTML. Every page reads without JavaScript.

Screenshots

A city page (/c/delhi)	Homepage on a phone

Use it on the web or as an API

Open and keyless.

• mugilu.live: type any place, in any language.
• A point: /c/12.97,77.59. A place: /c/bengaluru. For someone: /c/delhi?as=asthma.

# JSON, by coordinate or by name, optionally weighted for a vulnerability
curl https://mugilu.live/c/12.97,77.59.json
curl "https://mugilu.live/c/delhi.json?as=asthma"

A trimmed response (the full layers are air, heat, heat_vs_normal, rain, uv, dust, wind, visibility, smoke, warnings and nearby_warnings; ambient.order lists the readings in the order every surface shows them):

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗