Jasmica08 GitHub avatar

carbon-footprint-analyzer

Jasmica08

A Streamlit web app that estimates household carbon emissions from electricity, vehicle travel, and diet, projects them 1–10 years with a small regression model, and offers benchmarks and improvement tips.

Stars

19

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-30

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It is a self-contained educational project that combines established emission factors with a runtime-trained scikit-learn model, letting users see both current footprint and future projections without needing any external dataset.

Who it is for

  • Households wanting an approximate carbon footprint estimate
  • Python/Streamlit learners looking for a small runnable example
  • Sustainability educators needing a simple emission-benchmark demo
  • Developers curious about adding a lightweight ML model to a web app

Use cases

  • Estimate household emissions from electricity, vehicle travel, and food habits
  • Project personal footprint 1–10 years ahead under gradual grid decarbonisation
  • Use sliders to simulate behaviour changes and compare what-if scenarios
  • Download a plain-text carbon footprint report for personal or coursework use

Strengths

  • No external dataset download is required; emission factors are public constants
  • Interactive visualisations include pie chart breakdown, benchmarks, Eco Score, and ranked tips
  • The trend model is self-contained: it trains on synthetic data at runtime with scikit-learn
  • Clear local setup and GitHub upload/deployment instructions are included

Considerations

  • Emission factors are widely cited approximations, not certified carbon accounting
  • AI projections are trained on synthetic data generated at runtime, not on real historical data
  • Requires Python environment setup and manual launch; no pre-hosted demo link is included in the repo

README quick start

🌍 Carbon Footprint Analyzer

A Streamlit web app that estimates your household's carbon emissions from electricity usage, vehicle travel, and food habits — then uses a small regression model to project your yearly impact, benchmarks you against national/global averages, and gives a ranked improvement plan.

✨ Features

  • Emission breakdown (pie chart) across electricity / travel / food
  • Benchmark comparison vs. Average Indian, Global Average, Paris Agreement target
  • AI trend projection: a scikit-learn regression model (trained on synthetic data generated at runtime) projects your footprint 1–10 years ahead, factoring in gradual grid decarbonisation
  • Eco Score (A–F grade)
  • Ranked, personalised improvement tips
  • "What-if" simulator — drag sliders to see the impact of behaviour changes
  • Downloadable plain-text report

No external dataset download is required. All emission factors are well-established public constants (see app.py), and the "AI" trend model trains itself on synthetically generated data each time the app starts (see model.py).

🗂️ Project Structure

carbon-footprint-analyzer/
├── app.py              # Streamlit UI + calculations
├── model.py            # Synthetic-data regression model (the "AI" part)
├── requirements.txt    # Python dependencies
├── .gitignore
└── README.md

🖥️ Running it locally in VS Code

Yes — this project runs perfectly in VS Code. Steps:

  1. Install prerequisites

  2. Open the project folder in VS Code File → Open Folder… → select carbon-footprint-analyzer.

  3. Create a virtual environment (open a VS Code terminal: Ctrl+`)

    python -m venv venv
    

    Activate it:

    • Windows: venv\Scripts\activate
    • macOS/Linux: source venv/bin/activate VS Code will usually prompt "Select this environment" — click yes.
  4. Install dependencies

    pip install -r requirements.txt
    
  5. Run the app

    streamlit run app.py
    

    It opens automatically at http://localhost:8501.

⬆️ Uploading this project to GitHub

Checklist of what a project needs before pushing (all already included here): README.md, .gitignore, requirements.txt, and cle

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482