Skip to content

CS222-UIUC/team-22-project

Repository files navigation

CO2ntrol

CO2ntrol is a web application that automatically tracks and visualizes your personal carbon footprint by parsing utility bills and logging trip mileage. It combines OCR (Google Document AI) with the Google Maps API to eliminate manual data entry, and presents an interactive Chart.js dashboard so you can monitor—and reduce—your CO₂ emissions month by month.


FEATURES

  • Bill Upload
    Drag‑and‑drop any utility bill (PDF or image). Uses Google Document AI to extract usage data (kWh, therms, etc.).

  • Footprint Score
    Combines energy and travel into a single CO₂ total. Applies industry‑standard emission factors.

  • Dashboard
    Interactive line and pie charts built with Chart.js. Filter by category (energy vs. travel) and by date.

REQUIREMENTS

  • Node.js ≥ 14
  • Python 3.10+
  • Supabase CLI
  • A Google Cloud service account with Document AI enabled
  • Firebase project for Authentication

INSTALLATION & SETUP

bash git clone git@github.com:CS222-UIUC/team-22-project.git cd frontend npm install npm start

cd ../backend npm install node server.js

TECHNICAL ARCHITECTURE

alt text

GROUP ROLES

Manavi Chaudhry: Firebase Authentication, receipt classification, overall architecture

Isabel Chen: Frontend design, user input handling, chart visualization

Maya Ajit: Node.js backend, Supabase setup, Google Takeout mileage extraction

Advita Gelli: Google Document AI integration, file storage, CSS design, Carbon footprint calculation logic

About

CS 222 Team Project Repository - Team 22

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors