EricCRX/Upfront_Embodied_Carbon_Calculator

A1–A5 Upfront Embodied Carbon Calculator (Gradio)

A single-page Gradio app to compute A1–A5 upfront embodied carbon for building materials and processes. Enter rows of data (materials, transport, site energy/waste), get per-row results, per-module summary, total tCO2e, and optional reduction suggestions powered by a small LLM via Hugging Face Inference API.

Features

• —Deterministic A1–A5 backend (EN 15978 scope; RICS/IStructE/GHG Protocol units)
• —Units and aliases:
• —A1–A3/A5 materials/waste: kg|t × kgCO2e/kg or tCO2e/t
• —A4 transport: ton_km × kgCO2e/ton_km (aliases: t-km, t·km, ton-km)
• —A5 site energy: kWh × kgCO2e/kWh
• —Output: per-row kgCO2e|tCO2e, per-module summary, Total
• —Optional suggestions via Hugging Face Inference API (falls back to deterministic tips if no token)

Run locally

pip install -r requirements.txt
python app.py

Open the local URL printed by Gradio.

Deploy to Hugging Face Spaces

• —Create a new Space (Gradio Python)
• —Upload these files:
• —app.py
• —requirements.txt
• —README.md (optional)
• —In Space Settings → Secrets, set one of the following if you want LLM suggestions:
• —HUGGINGFACEHUB_API_TOKEN (recommended), or
• —HF_API_TOKEN

If no token is set, the app still runs and shows rule-based fallback suggestions.

Data columns (required)

module,name,quantity,unit,ef,ef_unit,notes

Examples:

• —Concrete (A1): 10000 kg × 0.12 kgCO2e/kg
• —Rebar (A1): 2000 kg → 2 t × 1.9 tCO2e/t
• —CLT (A3): 5 t × 0.35 tCO2e/t
• —Truck transport (A4): 800 ton_km × 0.1 kgCO2e/ton_km
• —Construction waste (A5): 2 t × 0.25 tCO2e/t

Notes

• —Backend validates missing columns, unsupported modules, and unit mismatches with clear errors
• —Transport aliases are normalized to ton_km
• —Keep provenance in notes (EPD/database/assumptions) for auditability

License

MIT (user content and EPD/IP remain their respective owners)