ANGEL-NTU/ESGenius

ESGenius: EMNLP 2025 Main Oral benchmark for LLM ESG and sustainability knowledge, with 1,136 questions, evaluation code, interactive heatmap, and Hugging Face dataset release.

18

stars

46

commits

HTML

primary language

Jun 15, 2026

updated

angel-ntu.github.io/ESGenius/
benchmark
climate-disclosure
dataset
emnlp
emnlp-2025
esg
evaluation
github-pages
huggingface
huggingface-datasets
large-language-models
llm
model-evaluation
nlp
retrieval-augmented-generation
sustainability
sustainability-reporting
Browse cluster: LLM and Vision-Language Model Evaluation

README

ESGenius logo

ESGenius

Benchmarking LLMs on Environmental, Social, and Governance (ESG) and Sustainability Knowledge

EMNLP 2025 Main Conference Oral | Resource and Theme Paper Award nominations, Top 1%

Project Site | Interactive Heatmap | Hugging Face Dataset | ACL Anthology | PDF | Dataset Card | Evaluation Guide

EMNLP 2025 Main Oral Project website Hugging Face dataset Model results License Apache 2.0


ESGenius is an expert multiple-choice benchmark for evaluating whether large language models understand ESG and sustainability knowledge in standards-aware settings. It includes 1,136 source-grounded questions, plain and reference-aware dataset files, evaluation scripts, published result figures, and an interactive 50-model heatmap for question-level diagnosis.

GoalStart here
Read the paperACL Anthology or PDF
Open the project pageangel-ntu.github.io/ESGenius
Inspect model-question outcomesInteractive heatmap
Use the Hugging Face releasecy0307/ESGenius
Download the plain benchmarkdata/ESGenius_1136q.csv or data/ESGenius_1136q.json
Use source-grounded referencesdata/ESGenius_w_ref_1136q.csv
Reproduce evaluationsEvaluation guide
Cite ESGeniusBibTeX or CITATION.cff

At a Glance

ItemDetails
PaperESGenius: Benchmarking LLMs on Environmental, Social, and Governance (ESG) and Sustainability Knowledge
VenueEMNLP 2025 Main Conference Oral
RecognitionResource and Theme Paper Award nominations, Top 1%
Questions1,136 multiple-choice ESG and sustainability questions
Answer protocolA, B, C, D, plus Z for "Not sure"
Evaluated models50 models with aggregate rankings and question-level heatmap results
Reference supportSource document names, page references, and supporting excerpts
Hugging Face releasecy0307/ESGenius
LicenseApache 2.0

Why ESGenius?

General factual benchmarks do not fully capture the domain-specific demands of ESG work. Sustainability reporting, climate disclosure, and governance analysis require specialized terminology, source-dependent concepts, and knowledge of reporting frameworks. ESGenius targets this gap directly.

  • Covers environmental, social, governance, and sustainability knowledge across major standards and disclosure contexts.
  • Draws from IPCC, GRI, SASB, ISO, IFRS/ISSB, TCFD, CDP, and related ESG sources.
  • Uses a controlled A-D multiple-choice format with Z for abstention or uncertainty.
  • Provides source-grounded reference fields for audit, retrieval, and citation-aware evaluation.
  • Includes reproducible evaluation scripts and published result artifacts.

What Is Included

ComponentPurpose
DatasetPlain CSV/JSON benchmark files and a reference-aware CSV
Evaluation codeLocal Hugging Face, reference-aware prompting, and Dashscope-compatible Qwen API paths
UtilitiesShared prompt formatting, prediction parsing, metrics, and Excel export helpers
ResultsRanking figure, paper figures, and generated evaluation outputs
WebpagePaper project site plus an interactive Plotly heatmap
Citation metadataCITATION.cff and EMNLP 2025 BibTeX

Repository Layout

PathPurpose
index.htmlGitHub Pages paper project site
heatmap.htmlInteractive 50-model model-question heatmap
assets/Site styles, JavaScript, and ESGenius logo
data/ESGenius_1136q.csvPlain benchmark in CSV format
data/ESGenius_1136q.jsonPlain benchmark in JSON format
data/ESGenius_w_ref_1136q.csvReference-aware benchmark with source metadata
data/README.mdDataset schema and usage notes
docs/evaluation.mdDetailed evaluation workflow guide
docs/huggingface_dataset_card.mdSource dataset card used for the Hugging Face release
evaluation_utils.pyShared loading, prompting, parsing, metrics, and export utilities
eval_opensource.pyLocal Hugging Face model evaluation
eval_opensource_rag.pyReference-aware prompting evaluation
eval_qwen_api.pyDashscope-compatible Qwen API evaluation
figures/Paper and website figures
results/Published result images and evaluation outputs
CITATION.cffCitation metadata

Hugging Face Release

The canonical public benchmark bundle is hosted at cy0307/ESGenius. It contains the dataset files, dataset documentation, citation metadata, license, and lightweight evaluation scripts so users can download the benchmark from the Hugging Face Hub while using GitHub for source development and the project site.

hf download cy0307/ESGenius \
  --type dataset \
  --local-dir ESGenius-HF

Dataset

The public dataset lives in data/ and is mirrored on Hugging Face. Use the plain files for standard model evaluation and the reference-aware file for audit or retrieval experiments.

FileUse
ESGenius_1136q.csvMain CSV benchmark for standard evaluation
ESGenius_1136q.jsonJSON mirror of the plain benchmark
ESGenius_w_ref_1136q.csvReference-aware version with ref_page, ref_doc, and source_text

Core fields:

ColumnDescription
query_idStable question identifier
new_idSequential question index
queryMultiple-choice question stem
A, B, C, DCandidate answer options
Z"Not sure" option
answerGold option label
ref_page, ref_doc, source_textReference metadata and excerpt in the reference CSV

See data/README.md for schema notes and usage guidance.

Quick Start

Create an environment:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Copy the environment template:

cp .env.example .env

Run a small local smoke test:

python eval_opensource.py \
  --dataset ESGenius_1136q.csv \
  --models Qwen/Qwen2.5-0.5B-Instruct \
  --limit 10

Results are written to results/ as Excel workbooks with summary and details sheets.

Evaluation Paths

All evaluation paths share normalization, option extraction, metric computation, and workbook export through evaluation_utils.py.

PathScriptTypical use
Local open-source modelseval_opensource.pyRun Hugging Face causal language models locally
Reference-aware promptingeval_opensource_rag.pyPrepend source snippets from the reference CSV
Qwen APIeval_qwen_api.pyEvaluate Dashscope-compatible Qwen models with retry handling

Reference-aware smoke test:

python eval_opensource_rag.py \
  --dataset ESGenius_w_ref_1136q.csv \
  --models Qwen/Qwen2.5-0.5B-Instruct \
  --limit 10

Qwen API smoke test:

python eval_qwen_api.py \
  --dataset ESGenius_1136q.csv \
  --models Qwen2.5-Max \
  --limit 10

For all options, output structure, and reproducibility notes, see docs/evaluation.md.

Results and Project Site

The project site follows a paper-project format and keeps the homepage lightweight. The full diagnostic view lives in the interactive heatmap.

Main ESGenius benchmark results

Main ESGenius benchmark results. Additional figures are available in figures/, results/, and on the project site.

Validate the static site locally:

python scripts/check_static_site.py
python -m http.server 8000

Then open http://127.0.0.1:8000/.

Reproducibility Checklist

  • Keep query_id as a string when loading datasets.
  • Keep the Z option in prompts; it is part of the benchmark protocol.
  • Use deterministic generation settings from evaluation_utils.py.
  • Existing result workbooks are skipped by default to avoid accidental overwrites.
  • Use --force only when intentionally regenerating outputs.
  • Report both accuracy and invalid or abstention behavior when comparing models.
  • Use the reference-aware CSV when an experiment depends on source snippets.

Citation

If you use ESGenius, please cite the EMNLP 2025 paper and repository metadata in CITATION.cff.

@inproceedings{he-etal-2025-esgenius,
  title = "{ESG}enius: Benchmarking {LLM}s on Environmental, Social, and Governance ({ESG}) and Sustainability Knowledge",
  author = "He, Chaoyue and Zhou, Xin and Wu, Yi and Yu, Xinjia and Zhang, Yan and Zhang, Lei and Wang, Di and Lyu, Shengfei and Xu, Hong and Xiaoqiao, Wang and Liu, Wei and Miao, Chunyan",
  editor = "Christodoulopoulos, Christos and Chakraborty, Tanmoy and Rose, Carolyn and Peng, Violet",
  booktitle = "Proceedings of the 2025 Conference on Empirical Methods in Natural Language Processing",
  month = nov,
  year = "2025",
  address = "Suzhou, China",
  publisher = "Association for Computational Linguistics",
  url = "https://aclanthology.org/2025.emnlp-main.739/",
  doi = "10.18653/v1/2025.emnlp-main.739",
  pages = "14612--14653",
  ISBN = "979-8-89176-332-6"
}

Contributing

Please see CONTRIBUTING.md for contribution guidance. For vulnerability reporting, see SECURITY.md.

License

This project is released under the Apache 2.0 License.

Contributors

ChaoYue0307

46 commits

ANGEL-NTU/ESGenius

ESGenius: EMNLP 2025 Main Oral benchmark for LLM ESG and sustainability knowledge, with 1,136 questions, evaluation code, interactive heatmap, and Hugging Face dataset release.

18

stars

46

commits

HTML

primary language

Jun 15, 2026

updated

angel-ntu.github.io/ESGenius/
benchmark
climate-disclosure
dataset
emnlp
emnlp-2025
esg
evaluation
github-pages
huggingface
huggingface-datasets
large-language-models
llm
model-evaluation
nlp
retrieval-augmented-generation
sustainability
sustainability-reporting
Browse cluster: LLM and Vision-Language Model Evaluation

README

ESGenius logo

ESGenius

Benchmarking LLMs on Environmental, Social, and Governance (ESG) and Sustainability Knowledge

EMNLP 2025 Main Conference Oral | Resource and Theme Paper Award nominations, Top 1%

Project Site | Interactive Heatmap | Hugging Face Dataset | ACL Anthology | PDF | Dataset Card | Evaluation Guide

EMNLP 2025 Main Oral Project website Hugging Face dataset Model results License Apache 2.0


ESGenius is an expert multiple-choice benchmark for evaluating whether large language models understand ESG and sustainability knowledge in standards-aware settings. It includes 1,136 source-grounded questions, plain and reference-aware dataset files, evaluation scripts, published result figures, and an interactive 50-model heatmap for question-level diagnosis.

GoalStart here
Read the paperACL Anthology or PDF
Open the project pageangel-ntu.github.io/ESGenius
Inspect model-question outcomesInteractive heatmap
Use the Hugging Face releasecy0307/ESGenius
Download the plain benchmarkdata/ESGenius_1136q.csv or data/ESGenius_1136q.json
Use source-grounded referencesdata/ESGenius_w_ref_1136q.csv
Reproduce evaluationsEvaluation guide
Cite ESGeniusBibTeX or CITATION.cff

At a Glance

ItemDetails
PaperESGenius: Benchmarking LLMs on Environmental, Social, and Governance (ESG) and Sustainability Knowledge
VenueEMNLP 2025 Main Conference Oral
RecognitionResource and Theme Paper Award nominations, Top 1%
Questions1,136 multiple-choice ESG and sustainability questions
Answer protocolA, B, C, D, plus Z for "Not sure"
Evaluated models50 models with aggregate rankings and question-level heatmap results
Reference supportSource document names, page references, and supporting excerpts
Hugging Face releasecy0307/ESGenius
LicenseApache 2.0

Why ESGenius?

General factual benchmarks do not fully capture the domain-specific demands of ESG work. Sustainability reporting, climate disclosure, and governance analysis require specialized terminology, source-dependent concepts, and knowledge of reporting frameworks. ESGenius targets this gap directly.

  • Covers environmental, social, governance, and sustainability knowledge across major standards and disclosure contexts.
  • Draws from IPCC, GRI, SASB, ISO, IFRS/ISSB, TCFD, CDP, and related ESG sources.
  • Uses a controlled A-D multiple-choice format with Z for abstention or uncertainty.
  • Provides source-grounded reference fields for audit, retrieval, and citation-aware evaluation.
  • Includes reproducible evaluation scripts and published result artifacts.

What Is Included

ComponentPurpose
DatasetPlain CSV/JSON benchmark files and a reference-aware CSV
Evaluation codeLocal Hugging Face, reference-aware prompting, and Dashscope-compatible Qwen API paths
UtilitiesShared prompt formatting, prediction parsing, metrics, and Excel export helpers
ResultsRanking figure, paper figures, and generated evaluation outputs
WebpagePaper project site plus an interactive Plotly heatmap
Citation metadataCITATION.cff and EMNLP 2025 BibTeX

Repository Layout

PathPurpose
index.htmlGitHub Pages paper project site
heatmap.htmlInteractive 50-model model-question heatmap
assets/Site styles, JavaScript, and ESGenius logo
data/ESGenius_1136q.csvPlain benchmark in CSV format
data/ESGenius_1136q.jsonPlain benchmark in JSON format
data/ESGenius_w_ref_1136q.csvReference-aware benchmark with source metadata
data/README.mdDataset schema and usage notes
docs/evaluation.mdDetailed evaluation workflow guide
docs/huggingface_dataset_card.mdSource dataset card used for the Hugging Face release
evaluation_utils.pyShared loading, prompting, parsing, metrics, and export utilities
eval_opensource.pyLocal Hugging Face model evaluation
eval_opensource_rag.pyReference-aware prompting evaluation
eval_qwen_api.pyDashscope-compatible Qwen API evaluation
figures/Paper and website figures
results/Published result images and evaluation outputs
CITATION.cffCitation metadata

Hugging Face Release

The canonical public benchmark bundle is hosted at cy0307/ESGenius. It contains the dataset files, dataset documentation, citation metadata, license, and lightweight evaluation scripts so users can download the benchmark from the Hugging Face Hub while using GitHub for source development and the project site.

hf download cy0307/ESGenius \
  --type dataset \
  --local-dir ESGenius-HF

Dataset

The public dataset lives in data/ and is mirrored on Hugging Face. Use the plain files for standard model evaluation and the reference-aware file for audit or retrieval experiments.

FileUse
ESGenius_1136q.csvMain CSV benchmark for standard evaluation
ESGenius_1136q.jsonJSON mirror of the plain benchmark
ESGenius_w_ref_1136q.csvReference-aware version with ref_page, ref_doc, and source_text

Core fields:

ColumnDescription
query_idStable question identifier
new_idSequential question index
queryMultiple-choice question stem
A, B, C, DCandidate answer options
Z"Not sure" option
answerGold option label
ref_page, ref_doc, source_textReference metadata and excerpt in the reference CSV

See data/README.md for schema notes and usage guidance.

Quick Start

Create an environment:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Copy the environment template:

cp .env.example .env

Run a small local smoke test:

python eval_opensource.py \
  --dataset ESGenius_1136q.csv \
  --models Qwen/Qwen2.5-0.5B-Instruct \
  --limit 10

Results are written to results/ as Excel workbooks with summary and details sheets.

Evaluation Paths

All evaluation paths share normalization, option extraction, metric computation, and workbook export through evaluation_utils.py.

PathScriptTypical use
Local open-source modelseval_opensource.pyRun Hugging Face causal language models locally
Reference-aware promptingeval_opensource_rag.pyPrepend source snippets from the reference CSV
Qwen APIeval_qwen_api.pyEvaluate Dashscope-compatible Qwen models with retry handling

Reference-aware smoke test:

python eval_opensource_rag.py \
  --dataset ESGenius_w_ref_1136q.csv \
  --models Qwen/Qwen2.5-0.5B-Instruct \
  --limit 10

Qwen API smoke test:

python eval_qwen_api.py \
  --dataset ESGenius_1136q.csv \
  --models Qwen2.5-Max \
  --limit 10

For all options, output structure, and reproducibility notes, see docs/evaluation.md.

Results and Project Site

The project site follows a paper-project format and keeps the homepage lightweight. The full diagnostic view lives in the interactive heatmap.

Main ESGenius benchmark results

Main ESGenius benchmark results. Additional figures are available in figures/, results/, and on the project site.

Validate the static site locally:

python scripts/check_static_site.py
python -m http.server 8000

Then open http://127.0.0.1:8000/.

Reproducibility Checklist

  • Keep query_id as a string when loading datasets.
  • Keep the Z option in prompts; it is part of the benchmark protocol.
  • Use deterministic generation settings from evaluation_utils.py.
  • Existing result workbooks are skipped by default to avoid accidental overwrites.
  • Use --force only when intentionally regenerating outputs.
  • Report both accuracy and invalid or abstention behavior when comparing models.
  • Use the reference-aware CSV when an experiment depends on source snippets.

Citation

If you use ESGenius, please cite the EMNLP 2025 paper and repository metadata in CITATION.cff.

@inproceedings{he-etal-2025-esgenius,
  title = "{ESG}enius: Benchmarking {LLM}s on Environmental, Social, and Governance ({ESG}) and Sustainability Knowledge",
  author = "He, Chaoyue and Zhou, Xin and Wu, Yi and Yu, Xinjia and Zhang, Yan and Zhang, Lei and Wang, Di and Lyu, Shengfei and Xu, Hong and Xiaoqiao, Wang and Liu, Wei and Miao, Chunyan",
  editor = "Christodoulopoulos, Christos and Chakraborty, Tanmoy and Rose, Carolyn and Peng, Violet",
  booktitle = "Proceedings of the 2025 Conference on Empirical Methods in Natural Language Processing",
  month = nov,
  year = "2025",
  address = "Suzhou, China",
  publisher = "Association for Computational Linguistics",
  url = "https://aclanthology.org/2025.emnlp-main.739/",
  doi = "10.18653/v1/2025.emnlp-main.739",
  pages = "14612--14653",
  ISBN = "979-8-89176-332-6"
}

Contributing

Please see CONTRIBUTING.md for contribution guidance. For vulnerability reporting, see SECURITY.md.

License

This project is released under the Apache 2.0 License.

Contributors

ChaoYue0307

46 commits

Languages

HTML

99.8%