🌱 CarbonWise

A carbon footprint tracking & coaching app to help you measure, understand, and reduce your environmental impact.

---

🔧Tech Stack

---

✨ Features

• 🚗 Tracking

Track lifestyle inputs: transport, energy, diet, waste

• 📊 Visualization

Detailed footprint breakdown with charts & visuals

• 💡 Tips

Personalized recommendations to cut emissions

• 🤖 AI

Rule-based AI powered coaching system

• 🔒 Authentication

Secure login with JWT + bcrypt

• 🌐 Access

Works online & offline with fallbacks

---

🌿 Carbon Footprint Engine

Category	Calculation Method
🚗 Transport	Mode factors → Car: 0.192 · Bus: 0.082 · Metro: 0.028 (kg/km)
⚡ Energy	Grid electricity → 0.70 kg/kWh
🍔 Diet	Multipliers → Meat-heavy: 1.3x · Vegetarian: 0.75x · Vegan: 0.6x
🗑️ Waste	Category-specific emission factors

👉 Outputs: Annual totals · % distribution · category breakdown

---

🏗️ System Architecture

Component	Technology	Purpose
Frontend	React 18 ⚛️ · TypeScript · Vite 🚀· TailwindCSS 🎨 · Chart.js 📊	User interface & visualization
Backend	FastAPI ⚡ · Uvicorn 🔥 · Pydantic	API & business logic
Data	CSV (emission_factors.csv) + In-memory storage	Emission factors & user/auth
Auth	JWT 🔑 (python-jose) · bcrypt 🔒 (passlib)	Secure login & signup

---

⚡ Backend Routes

Route	Purpose
/estimate	Calculate carbon footprint
/recommend	Get reduction suggestions
/coach	AI-based coaching
/auth	Signup & login
/factors	Get emission factors

---

📸 App Preview

🏠 Home Page

---

🧮 Carbon Calculator

---

🤖 AI Coach

---

🔑 Sign Up

---

🔐 Log In

---

---

🚀Getting Started

📥 Clone & Install

git clone https://github.com/roseewood/CarbonWise.git
cd CarbonWise

⚙️ Backend setup

cd backend
python3 -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
pip install -r requirements.txt

🎨 Frontend setup

cd ../frontend
npm install

---

▶️ Run in Development

🖥️ Backend

cd backend
uvicorn app:app --reload

🌐 Frontend (in a new terminal)

cd frontend
npm run dev

Both servers should now be live ✨

• 🔗 API → http://127.0.0.1:8000
• 💻 React app → http://localhost:5173

---

❓ Why CarbonWise

Because sustainability should be simple. No jargon. No guilt. Just clear insights, easy actions, and real impact.

💡 Recommendation System

• 📊 Algorithm: Rule-based (targets highest category)
• 🎯 Personalized: Suggestions tailored to footprint breakdown
• 🌍 Impact: Estimated CO₂ savings per action
• Categories:
  • 🚗 Transport switching
  • ⚡ Energy efficiency
  • 🍴 Dietary changes
  • ♻️ Waste reduction

---

MIT License © 2025 · Built with 💚 for a greener future