Skip to content

limem01/climabyte

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

6 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ ClimaByte

AI-Powered Personal Carbon Footprint Tracker

Frostbyte Hackathon 2026 โ€” Sustainability & Climate Tech

Live Demo

Python Streamlit Claude AI Plotly License

Scan receipts. Track your impact. Save the planet โ€” one purchase at a time.


๐Ÿ“ธ Screenshots

Dashboard with Live Analytics Transport Emissions Comparison
Dashboard Transport
Food & Grocery Tracker Learn & Discover
Add Items Learn

๐ŸŽฏ What It Does

Feature Description
๐Ÿ“ธ Scan Receipts Upload a grocery receipt photo โ€” Claude Vision extracts items and calculates carbon footprint instantly
๐Ÿ›’ Manual Tracking Search or browse 80+ food items with real emission data from EPA/DEFRA
๐Ÿš— Transport Tracker Log commutes across 15 transport modes with side-by-side comparisons
๐Ÿ  Home Energy Track electricity & heating by source (including Quebec's near-zero hydro grid!)
๐Ÿค– AI Climate Coach Personalized, encouraging tips from Claude โ€” data-driven, never preachy
๐Ÿ“ˆ Visual Dashboard Interactive Plotly charts: category breakdown, item comparison, country benchmarks
๐Ÿ“š Learn Educational content with food comparisons, top 5 actions, and data sources

๐Ÿ’ก Why ClimaByte?

People can't change what they can't measure.

Most people want to reduce their carbon footprint but have no idea where to start. ClimaByte bridges the knowledge gap:

  • ๐Ÿ‘๏ธ See the impact of every purchase in kg COโ‚‚e
  • ๐Ÿ”„ Compare alternatives โ€” "What if I swapped beef for chicken?"
  • ๐Ÿค– Get coached by AI that's encouraging, not judgmental
  • ๐Ÿ“Š Track progress with beautiful, real-time visualizations
  • ๐ŸŒ Benchmark yourself against global and country averages

๐Ÿ› ๏ธ Tech Stack

Layer Technology Why
Language Python 3.12 Massive AI ecosystem, hackathon-proven
Frontend Streamlit 1.55 Production-quality web UI from pure Python
AI Brain Claude API (claude-sonnet-4-6) Multimodal vision + structured JSON + natural coaching
Carbon Data Built-in DB (80+ items) Real emission factors from EPA, DEFRA, Climatiq OEFDB
Charts Plotly Express Interactive, beautiful, responsive visualizations
Image Processing Pillow (PIL) Receipt photo handling before Claude Vision
Deployment Streamlit Community Cloud Free, instant, auto-deploy from GitHub

Total cost: $0 โ€” Everything runs on free tiers.


๐Ÿš€ Quick Start

# Clone
git clone https://github.com/limem01/climabyte.git
cd climabyte

# Setup
python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

# Run
streamlit run app.py

Opens at http://localhost:8501 โœจ

๐Ÿ”‘ API Keys (Optional)

Key Required? What it unlocks
Anthropic Claude Optional Receipt scanning (Vision) + AI coaching
Climatiq Optional Enhanced emission data

The app works fully without any API keys using the built-in emission factor database.


๐Ÿ—๏ธ How We Built It

ClimaByte was built for the Frostbyte Hackathon 2026. The core insight: people can't change what they can't measure.

Architecture

๐Ÿ“ธ Receipt Photo โ†’ Claude Vision โ†’ Structured JSON โ†’ Emission Database Match โ†’ COโ‚‚e Calculation
                                                                                    โ†“
๐Ÿ›’ Manual Entry โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ†’ Carbon Engine โ”€โ”€โ†’ Dashboard + Charts
                                                              โ†‘                     โ†“
๐Ÿš— Transport / ๐Ÿ  Energy โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜              ๐Ÿค– AI Coach Tips

Key decisions:

  • Built-in emission data (not API-only) so the app works even offline
  • Claude claude-sonnet-4-6 for the perfect balance of speed, intelligence, and cost
  • Streamlit for rapid prototyping โ€” professional UI in hours, not weeks
  • Session-based storage for hackathon simplicity (Firebase/Supabase planned for v2)

Carbon Data Sources

All emission factors come from peer-reviewed, authoritative sources:

  • Climatiq OEFDB โ€” Open Emission Factor Database
  • EPA โ€” US Environmental Protection Agency
  • DEFRA โ€” UK Dept. for Environment, Food & Rural Affairs
  • Our World in Data โ€” Oxford lifecycle analyses
  • IPCC AR6 โ€” Intergovernmental Panel on Climate Change

๐Ÿ“Š Impact by the Numbers

Metric Value
Food items tracked 80+ with real COโ‚‚e data
Transport modes 15 from walking to long-haul flights
Energy sources 9 including Quebec hydro (0.002 kg/kWh!)
Country benchmarks 10 including Paris 1.5ยฐC target
API cost $0 for full functionality

๐Ÿ”ฎ What's Next

  • ๐Ÿ”ฅ Firebase/Supabase persistent storage
  • ๐Ÿ“ง Weekly/monthly progress reports via email
  • ๐Ÿ“ฑ Barcode scanning for packaged products
  • ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Household mode (track family footprint)
  • ๐ŸŒฑ Carbon offset marketplace integration
  • ๐Ÿ“ฒ Mobile PWA wrapper
  • ๐Ÿ† Social features โ€” compare with friends, community challenges

๐Ÿ‘ค Author

Khalil Limem

Full-stack developer passionate about using AI to solve real-world problems.

GitHub Email


Built with ๐ŸŒ for the Frostbyte Hackathon 2026

About

๐ŸŒ AI-Powered Personal Carbon Footprint Tracker โ€” Scan receipts, track food/transport/energy emissions, get AI coaching. Built with Claude AI + Streamlit.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages