Breathe
Free and open source · Jammu & Kashmir and Ladakh

Know what you're breathing.

Breathe is a community-run air quality network for Jammu & Kashmir and Ladakh. We put sensors on rooftops and balconies across the region, publish every reading in the open, and show it in a free app anyone can use.

"Breathe, breathe in the air. Don't be afraid to care." Pink Floyd

21
ground sensors
25
zones tracked
13
zones with sensors on the ground
₹0
to use, no account, no ads
Why it exists

Official air data here is thin, slow and hard to check

Jammu, Kashmir and Ladakh have very few government reference stations. Most apps fill the gap with satellite estimates that nobody checks against the ground, and the official numbers that do exist come out as monthly averages with no way to see how they were worked out.

That doesn't help someone deciding whether to send their kids out today, or whether the smoke over their street is as bad as it looks. Breathe exists to answer that with real, local, up to the minute readings, and to show every step of how a number was made so anyone can check it.

Air quality information should be accurate, immediate and verifiable, and it should belong to the people breathing the air.

Map of government air quality stations in Jammu and Kashmir, showing only three
Only 3 government CAAQMS ground stations cover the whole of J&K.
Monthly air quality report published by JKPCB
JKPCB publishes monthly averages only, with no way to see how they were derived. One reading at the end of the month would give the same number as thirty days of measurements.
How it works

From a rooftop sensor to your phone

  1. 1

    Sensors measure the air

    AirGradient outdoor monitors on homes, shops and campuses measure fine dust (PM2.5 and PM10), temperature and humidity around the clock and report it over Wi-Fi every 15 minutes.

  2. 2

    We check it and compute the AQI

    Our open API averages the sensors in each zone, drops readings that look broken, and turns the result into both the US EPA AQI and India's NAQI. Where there's no sensor yet, it uses CAMS satellite data and says so.

  3. 3

    You see it, anywhere

    The web app, the Android and iOS apps and the Discord bot all read the same live data, with a map, 24 hour trends, history, health advice and the cigarette equivalent of what you're breathing.

Ground sensors

What's actually in the air on your street

AirGradient kits, both official ones and India-assembled open hardware. They catch local smoke and dust spikes as they happen and are what we trust first.

Satellite model (CAMS)

A regional estimate where we have no sensor

Modelled data from Copernicus through Open-Meteo. Good for regional trends, but it can miss what's happening locally, which is why every zone is labelled with its source.

The exact AQI method For anyone who wants to check our maths
  1. Data acquisition

    Ground sensors (AirGradient) come first. If a sensor is offline, its data is stale, or it reports an unrealistic spike, that zone falls back to satellite modelling (Open-Meteo / CAMS).

  2. Multi-sensor averaging

    When a zone has several sensors, their readings are averaged before the AQI formula is applied. Erratic sensors are flagged and left out through a grace period mechanism.

  3. Sub-index for each pollutant

    Each pollutant (PM2.5, PM10, NO2, SO2, CO, O3) gets its own sub-index from the official breakpoint formula shared by the US EPA and CPCB, using each standard's own breakpoint table, capped at 500.

    I = Ihi−Ilo Chi−Clo × (C−Clo) + Ilo

    C is the measured concentration, Clo and Chi are the breakpoints either side of it, and Ilo and Ihi are the index values at those breakpoints.

  4. The highest sub-index wins

    The AQI is the maximum sub-index, not an average, and the pollutant behind it is shown as the main pollutant. Both Indian NAQI and US EPA AQI are computed and returned.

  5. Two time windows

    Live AQI uses the latest readings so spikes show up straight away. A separate 24 hour rolling average AQI follows the CPCB and EPA rules for official reporting. Both come back in every API response, along with the saved history.

Read the code that does this
Coverage

Where we measure today

We track 25 zones across Jammu, Kashmir and Ladakh. 13 cities have sensors on the ground, and the other 12 run on satellite data until someone hosts a sensor there.

Ground sensors Satellite only
Bandipora
Doda
Ganderbal
Jammu
Kargil
Kathua
Leh
Poonch
Rajouri
Reasi
Samba
Srinagar
Udhampur
Anantnag
Baramulla
Handwara
Katra
Kishtwar
Kulgam
Kupwara
Pahalgam
Pulwama
Ramban
Shopian
Sopore

Live in one of the satellite zones? A sensor at your place would give it real readings, and it's free.

Host a sensor
Get Breathe

Same data, wherever you are

Every app reads the same live network through the same open API.

Android

Material You theming, AMOLED dark mode and home screen widgets. Android 8.1 and up.

iOS, iPadOS and macOS

A native SwiftUI app with a map overlay, 24 hour graph and widgets, on iPhone, iPad and Mac.

Discord bot

Slash commands for any zone, fuzzy place names, 24 hour trend graphs and cigarette equivalence, right in your server.

Public API

Every reading is free to use, with no key needed. Build your own dashboard, research or bot on top of it.

Desktop Early

A native Qt 6 app for Linux, Windows and macOS. It is still an early proof of concept.

Host a sensor

Help expand the network

Coverage is still the biggest gap in Breathe. About half of our zones run on satellite models because there is no sensor on the ground, and a model can't see the smoke from a kiln down the road. Hosting a sensor puts real readings on the map for your whole area, and it costs you nothing.

We send the sensor

An AirGradient outdoor monitor, shipped to you for free. We pay for the hardware and the shipping, and it stays a BreatheOSS project sensor that you look after for the network.

We help you set it up

All it needs is an outdoor spot with open air (a balcony, a wall or a rooftop) and your Wi-Fi. We'll walk you through mounting and connecting it.

We keep it powered

Power cuts are common in a lot of places here, so we'll send power banks and whatever else it takes to keep the sensor online through them.

We stay in touch

If it goes offline or the readings look off, tell us and we'll work through it with you until it's fixed.

Want one at your place?

Reach out on any of these and tell us roughly where you are.

Other ways to help

Code, funding and spreading the word

Write code

Everything we run is open source on GitHub (the Android and iOS apps, the web app, the API and the Discord bot), and pull requests are welcome. They go through the same review our own code does, so here's how we work.

  • Keep it simple. Plain, readable code over clever code, no new frameworks or dependencies unless there's really no other way, and no comments that just repeat what the code already says.
  • Small, atomic commits. One change per commit, every commit builds on its own, and every commit is signed off with git commit -s. Match the subject style you see in that repo's history.
  • Be honest with the data. Never fake, pad or smooth a reading. If a number is modelled, stale or missing, the app should say so.
  • LLMs are fine, slop isn't. Use whatever tools help you, but say which model you used in the PR description. You have to understand every line you send and be able to explain it in review, and pull requests that read like unreviewed AI output get closed.
  • Test it first. Run what you changed on a real device or browser before you open the PR, and say what you tested.

Fund the network

Donations go straight into sensors, power banks and the server that keeps it all running. Any amount helps, over UPI to either of these.

Want to do more than a one-off donation, like sponsoring a sensor or a whole area? Email [email protected] and we'll work it out together.

Spread the word

Share Breathe with people who care about the air they breathe. To promote it, or collaborate on a post or a campaign, DM us on Instagram.

What we stand for

Open by default, run for the public

The code is open so anyone can audit what we claim, the method is written down so anyone can challenge it, and the data is free so anyone can use it. Our charter makes that binding.

Open source

Everything we build is released under an open-source licence, from the apps to the API.

Open data

Air measurements are a public good, so they stay free for anyone to read, download and reuse.

Nothing hidden

Assumptions, processing, calibration and method changes are documented, so results can be reproduced.

Non-profit

Breathe runs for the public, not for profit. Any money that comes in goes back into the network.

Independent

We aren't affiliated with the CPCB, JKPCB or any government agency, and no result is bent to suit anyone.

Built to outlast us

No founder owns the project. It's set up to keep going whoever runs it, and people who contribute take part in how it's run.

Questions

Things people usually ask

Is Breathe run by the government?

No. Breathe is an independent, non-profit community project. It isn't affiliated with the CPCB, JKPCB or any government agency.

Why does the US AQI number differ from India's NAQI?

They're two different scales built from the same measurements. The US EPA scale is stricter at the low end, so the same air can read 104 on the US scale and 60 on NAQI. The apps show US AQI by default and you can switch to NAQI in settings.

How accurate are these sensors?

They aren't as precise as a government reference station, but they're very good at what matters most here, which is catching real spikes and trends as they happen at street level, in places that had no measurement at all. Sensors that start reporting nonsense are dropped automatically, and every number comes with its source so you can judge it yourself.

What happens where there's no sensor?

We use CAMS satellite and model data from Open-Meteo, and the apps label those zones "Satellite and model data" so you always know which kind of number you're looking at. Hosting a sensor is how a zone gets real readings.

Does it cost anything, or track me?

No. The apps are free, there are no accounts and no ads, and the places you pin stay on your own device. The privacy policy has the details.

Can I use the data for my own project?

Yes. The API is public and needs no key, and it serves live readings, history and the sensor list. If you build something with it, tell us, we'd love to see it.

The people

Who builds Breathe

A small team from Jammu, Kashmir and Ladakh, and everyone who has sent code, hosted a sensor or helped along the way.

Want to be on this list? Here's how to help