A carbon footprint tracking & coaching app to help you measure, understand, and reduce your environmental impact.
- 🚗 Tracking
- 📊 Visualization
- 💡 Tips
- 🤖 AI
- 🔒 Authentication
- 🌐 Access
Track lifestyle inputs: transport, energy, diet, waste
Detailed footprint breakdown with charts & visuals
Personalized recommendations to cut emissions
Rule-based AI powered coaching system
Secure login with JWT + bcrypt
Works online & offline with fallbacks
| 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
| 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 |
| Route | Purpose |
|---|---|
| /estimate | Calculate carbon footprint |
| /recommend | Get reduction suggestions |
| /coach | AI-based coaching |
| /auth | Signup & login |
| /factors | Get emission factors |
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
🖥️ 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
Because sustainability should be simple. No jargon. No guilt. Just clear insights, easy actions, and real impact.
- 📊 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