WIP AGPL-3.0Explain Simply

Scope Calc

Concise Scope 3 Emissions Calculator - Open Source with XBRL Export, Licensed under AGPL-3.0

Status
WIP
License
AGPL-3.0
Category
Explain Simply
Updated
GitHub source

Project status

Description

Scope Calc is open-source software for calculating and reporting corporate greenhouse gas emissions, compliant with the requirements of the Corporate Sustainability Reporting Directive (CSRD, EU Directive 2022/2464) and the European Sustainability Reporting Standards (ESRS) E1 Climate Change. It solves a concrete and urgent problem: from 2026 large EU companies (>250 employees, >€40M revenue, >€20M assets) must publish an ESRS-compliant sustainability report, and from 2027 listed SMEs too. Scope 3 calculation (indirect upstream/downstream emissions: purchases, transport, product use, end-of-life) is the most complex and typically covers 60-90% of the total carbon footprint. Scope Calc offers a structured calculator for: Scope 1 (direct combustion, industrial processes, F-gas refrigerant leaks), Scope 2 (purchased electricity, heat, steam, cooling, location-based vs market-based), Scope 3 across the 15 GHG Protocol categories (purchased goods/services, capital goods, upstream energy activities, upstream/downstream transportation, operational waste, business travel, commuting, upstream/downstream assets, processing of sold products, use of sold products, end-of-life, investments, franchising). The data model supports emission factors from DEFRA UK, ADEME France, ISPRA Italy, EPA US, with a pluggable provider. The output is multiple: a structured ESRS E1 PDF report, an XBRL dataset for EFRAG filing (ESRS digital reporting taxonomy), CSV/Excel for internal audit, an Angular dashboard for real-time monitoring of year-over-year reduction. AGPL-3.0 license for platform protection (anyone who forks to offer a CSRD service to third parties must open-source their modifications). Deployment target: ESG consultants, corporate sustainability managers, audit firms (Big4 alternatives), green tech startups. The philosophy is 'compliance as commodity': the ESRS standard is public, and the calculation should not be monetized as a premium SaaS.

Key Features

  • Scope 1 and Scope 2 Calculator

    Direct combustion, industrial processes, F-gas refrigerants, electricity location-based vs market-based, district heating/cooling.

  • Scope 3 GHG Protocol 15 categories

    All 15 upstream and downstream GHG protocol categories, mapping to ESRS E1-6 disclosure requirements, category traceability.

  • Multi-Provider Emission Factors

    DEFRA UK, ADEME France, ISPRA Italy, EPA US, IPCC AR6, plug-in provider through interface, annual reporting by year.

  • XBRL export EFRAG taxonomy

    Conform to XBRL taxonomy - Digital Reporting for ESRS, EFRAG, Pre-Filing Validation Ready for AgID/SEC/CSSF Submission.

  • Structured PDF report for ESRS E1

    Structured template PDF according to ESRS E1 disclosure requirements (E1-1 transition plan, E1-4 targets, E1-5 energy, E1-6 GHG).

  • Real-time Angular Dashboard

    Dashboard Angular 21 SSR with emission trend graphs, breakdown by scope, target progress, and what-if analysis reduction.

  • Audit trail and assurance are ready.

    Concise data entry log with reversible calculations, method version pin, audit package export with all reversible computations, ready for assurance limited/reasonable review.

  • Multi-tenant for consultants

    Multi-tenant architecture optional for ESG consultants managing multiple clients, Role-Based Access Control (RBAC) for clients/operators, data segregation.

Tech stack

  • Spring Boot 3.4
  • Java 21
  • Angular 21
  • CSRD ESRS
  • XBRL
  • PostgreSQL 16
  • GHG Protocol
  • Docker Compose

Use cases

  • Large EU-mandated enterprise CSRD (over 250 employees) seeking open-source, self-hosted tool.
  • Corporate ESg consultant managing 10-50 clients and seeking annual reporting automation.
  • Corporate sustainability manager seeking alternative to premium SaaS solutions (Sphera, Watershed, Persefoni)
  • Audit firm seeking independent tool for assurance on limited/reasonable report under ESRS

Road Map

  1. v0.1.0Scheduled

    Core: Scope 1 and Scope 2 plus UI Base

    • Scope 1 calculator (combustion + F-gas)
    • Scope 2 calculator (location + market based)
    • Emissions Factors from DEFRA and ISPRA Provider
    • Data Input and Graphs Breakdown
  2. v0.5.0Scheduled

    Scope 3 + Report PDF + Audit Trail

    • Scope 3 GHG Protocol 15 categories
    • ADEME + EPA + IPCC AR6 providers
    • Report PDF ESRS E1 Template
    • Append-Only Ledger Audit Trail
  3. v1.0.0Scheduled

    XBRL + Multi-Tenant + Production Deploy

    • XBRL EFRAG Taxonomy Export
    • Multi-tenant for consultant ESG
    • Limited/Reasonable Export of Assurance Pack
    • Documentation for MkDocs + Compliance Guide (ESRS)

Who is it for

  • For Developer Senior
  • Decision Maker/Founder

Quick start

Start the project locally in just a few commands. 

# Quick start (work-in-progress, repo non ancora pubblicato)
# git clone https://github.com/<tba>/scope-calc.git
# cd scope-calc
# cp .env.example .env  # configura DB, emission factor provider keys
# docker compose up -d  # postgres + scope-calc-backend + scope-calc-frontend

Contribute to the project

Scope Calc is open source. Open an issue, propose a pull request or leave a star on GitHub: every contribution, no matter how small, is welcome.

  • ⭐ Leave a star if it's useful
  • 🐛 Report bugs or suggest features via issue
  • 🔧 Send a pull request with fixes or improvements
  • 📣 Share the project if you find it interesting
Star on GitHubOpen an issuePull request
← ⭐ View on GitHub