crfm-helm 0.5.3__tar.gz → 0.5.5__tar.gz

crfm_helm-0.5.5/MANIFEST.in

@@ -0,0 +1,9 @@
+recursive-include src/helm/ py.typed
+recursive-include src/helm/tokenizers/ *.sp
+recursive-include src/helm/benchmark/ *.json
+recursive-include src/helm/benchmark/static/ *.css *.html *.js *.png *.yaml
+recursive-include src/helm/benchmark/static_build/ *.css *.html *.js *.png *.yaml
+recursive-include src/helm/config/ *.yaml
+recursive-include src/helm/benchmark/annotation/omni_math/ *.txt
+recursive-include src/helm/benchmark/annotation/wildbench/ *.md
+recursive-include src/helm/proxy/static/ *.css *.html *.js *.png

crfm_helm-0.5.5/PKG-INFO

@@ -0,0 +1,413 @@
+Metadata-Version: 2.4
+Name: crfm-helm
+Version: 0.5.5
+Summary: Benchmark for language models
+Home-page: https://github.com/stanford-crfm/helm
+Author: Stanford CRFM
+Author-email: contact-crfm@stanford.edu
+License: Apache License 2.0
+Keywords: language models benchmarking
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: Apache Software License
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cattrs~=22.2
+Requires-Dist: dacite~=1.6
+Requires-Dist: importlib-resources~=5.10
+Requires-Dist: Mako~=1.2
+Requires-Dist: numpy<3,~=1.26
+Requires-Dist: pandas~=2.0
+Requires-Dist: pyhocon~=0.3.59
+Requires-Dist: retrying~=1.3
+Requires-Dist: spacy~=3.5
+Requires-Dist: tqdm~=4.64
+Requires-Dist: zstandard~=0.18.0
+Requires-Dist: sqlitedict<3.0,>=2.1.0
+Requires-Dist: bottle~=0.12.23
+Requires-Dist: datasets~=2.17
+Requires-Dist: pyarrow>=11.0.0
+Requires-Dist: pyarrow-hotfix~=0.6
+Requires-Dist: nltk!=3.9.0,~=3.7
+Requires-Dist: rouge-score~=0.1.2
+Requires-Dist: scipy~=1.10
+Requires-Dist: uncertainty-calibration~=0.1.4
+Requires-Dist: scikit-learn~=1.1
+Requires-Dist: transformers~=4.40
+Requires-Dist: torch<3.0.0,>=1.13.1
+Requires-Dist: torchvision<3.0.0,>=0.14.1
+Provides-Extra: proxy-server
+Requires-Dist: gunicorn>=20.1; extra == "proxy-server"
+Provides-Extra: human-evaluation
+Requires-Dist: scaleapi~=2.13.0; extra == "human-evaluation"
+Requires-Dist: surge-api~=1.1.0; extra == "human-evaluation"
+Provides-Extra: scenarios
+Requires-Dist: gdown~=5.1; extra == "scenarios"
+Requires-Dist: sympy~=1.11.1; extra == "scenarios"
+Requires-Dist: xlrd~=2.0.1; extra == "scenarios"
+Provides-Extra: metrics
+Requires-Dist: google-api-python-client~=2.64; extra == "metrics"
+Requires-Dist: numba~=0.56; extra == "metrics"
+Requires-Dist: sacrebleu~=2.2.1; extra == "metrics"
+Requires-Dist: langdetect~=1.0.9; extra == "metrics"
+Requires-Dist: immutabledict~=4.2.0; extra == "metrics"
+Requires-Dist: gradio_client~=1.3; extra == "metrics"
+Provides-Extra: ranking
+Requires-Dist: pytrec_eval==0.5; extra == "ranking"
+Provides-Extra: summarization
+Requires-Dist: summ-eval~=0.892; extra == "summarization"
+Requires-Dist: bert-score~=0.3; extra == "summarization"
+Provides-Extra: plots
+Requires-Dist: colorcet~=3.0.1; extra == "plots"
+Requires-Dist: matplotlib~=3.6.0; extra == "plots"
+Requires-Dist: seaborn~=0.11.0; extra == "plots"
+Provides-Extra: decodingtrust
+Requires-Dist: fairlearn~=0.9.0; extra == "decodingtrust"
+Provides-Extra: slurm
+Requires-Dist: simple-slurm~=0.2.6; extra == "slurm"
+Provides-Extra: cleva
+Requires-Dist: unidecode~=1.3; extra == "cleva"
+Requires-Dist: pypinyin~=0.49.0; extra == "cleva"
+Requires-Dist: jieba~=0.42.1; extra == "cleva"
+Requires-Dist: opencc~=1.1; extra == "cleva"
+Requires-Dist: langdetect~=1.0; extra == "cleva"
+Provides-Extra: images
+Requires-Dist: crfm-helm[accelerate]; extra == "images"
+Requires-Dist: pillow~=10.2; extra == "images"
+Provides-Extra: mongo
+Requires-Dist: pymongo~=4.2; extra == "mongo"
+Provides-Extra: unitxt
+Requires-Dist: evaluate~=0.4.1; extra == "unitxt"
+Provides-Extra: seahelm
+Requires-Dist: pythainlp==5.0.0; extra == "seahelm"
+Requires-Dist: pyonmttok==1.37.0; extra == "seahelm"
+Requires-Dist: sacrebleu~=2.2.1; extra == "seahelm"
+Requires-Dist: python-crfsuite~=0.9.11; extra == "seahelm"
+Provides-Extra: accelerate
+Requires-Dist: accelerate~=0.25; extra == "accelerate"
+Provides-Extra: aleph-alpha
+Requires-Dist: aleph-alpha-client~=2.14.0; extra == "aleph-alpha"
+Requires-Dist: tokenizers>=0.13.3; extra == "aleph-alpha"
+Provides-Extra: allenai
+Requires-Dist: ai2-olmo~=0.2; extra == "allenai"
+Provides-Extra: amazon
+Requires-Dist: boto3~=1.34.131; extra == "amazon"
+Requires-Dist: awscli~=1.33.13; extra == "amazon"
+Requires-Dist: botocore~=1.34.131; extra == "amazon"
+Provides-Extra: anthropic
+Requires-Dist: anthropic~=0.39; extra == "anthropic"
+Requires-Dist: websocket-client~=1.3.2; extra == "anthropic"
+Requires-Dist: httpx<0.28.0; extra == "anthropic"
+Provides-Extra: cohere
+Requires-Dist: cohere~=5.3; extra == "cohere"
+Provides-Extra: mistral
+Requires-Dist: mistralai~=1.1; extra == "mistral"
+Provides-Extra: openai
+Requires-Dist: openai~=1.64; extra == "openai"
+Requires-Dist: tiktoken~=0.7; extra == "openai"
+Requires-Dist: pydantic~=2.0; extra == "openai"
+Provides-Extra: google
+Requires-Dist: google-cloud-aiplatform~=1.48; extra == "google"
+Provides-Extra: together
+Requires-Dist: together~=1.1; extra == "together"
+Provides-Extra: yandex
+Requires-Dist: sentencepiece~=0.2.0; extra == "yandex"
+Provides-Extra: models
+Requires-Dist: crfm-helm[ai21]; extra == "models"
+Requires-Dist: crfm-helm[accelerate]; extra == "models"
+Requires-Dist: crfm-helm[aleph-alpha]; extra == "models"
+Requires-Dist: crfm-helm[allenai]; extra == "models"
+Requires-Dist: crfm-helm[amazon]; extra == "models"
+Requires-Dist: crfm-helm[anthropic]; extra == "models"
+Requires-Dist: crfm-helm[cohere]; extra == "models"
+Requires-Dist: crfm-helm[google]; extra == "models"
+Requires-Dist: crfm-helm[mistral]; extra == "models"
+Requires-Dist: crfm-helm[openai]; extra == "models"
+Requires-Dist: crfm-helm[reka]; extra == "models"
+Requires-Dist: crfm-helm[together]; extra == "models"
+Requires-Dist: crfm-helm[yandex]; extra == "models"
+Requires-Dist: crfm-helm[ibm-enterprise-scenarios]; extra == "models"
+Provides-Extra: reka
+Requires-Dist: reka-api~=2.0.0; extra == "reka"
+Provides-Extra: vlm
+Requires-Dist: crfm-helm[openai]; extra == "vlm"
+Requires-Dist: einops~=0.7.0; extra == "vlm"
+Requires-Dist: einops-exts~=0.0.4; extra == "vlm"
+Requires-Dist: open-clip-torch~=2.24; extra == "vlm"
+Requires-Dist: torch~=2.1; extra == "vlm"
+Requires-Dist: transformers_stream_generator~=0.0.4; extra == "vlm"
+Requires-Dist: scipy~=1.10; extra == "vlm"
+Requires-Dist: torchvision<3.0.0,>=0.14.1; extra == "vlm"
+Requires-Dist: crfm-helm[reka]; extra == "vlm"
+Requires-Dist: crfm-helm[images]; extra == "vlm"
+Requires-Dist: crfm-helm[image2struct]; extra == "vlm"
+Requires-Dist: pycocoevalcap~=1.2; extra == "vlm"
+Requires-Dist: transformers~=4.45.2; extra == "vlm"
+Requires-Dist: qwen-vl-utils~=0.0.8; extra == "vlm"
+Provides-Extra: ibm-enterprise-scenarios
+Requires-Dist: openpyxl~=3.1; extra == "ibm-enterprise-scenarios"
+Provides-Extra: ibm
+Requires-Dist: ibm-watsonx-ai~=1.2.6; extra == "ibm"
+Provides-Extra: image2struct
+Requires-Dist: crfm-helm[images]; extra == "image2struct"
+Requires-Dist: latex~=0.7.0; extra == "image2struct"
+Requires-Dist: pdf2image~=1.16.3; extra == "image2struct"
+Requires-Dist: selenium~=4.17.2; extra == "image2struct"
+Requires-Dist: html2text~=2024.2.26; extra == "image2struct"
+Requires-Dist: opencv-python<4.8.2.0,>=4.7.0.68; extra == "image2struct"
+Requires-Dist: lpips~=0.1.4; extra == "image2struct"
+Requires-Dist: imagehash~=4.3.1; extra == "image2struct"
+Provides-Extra: heim
+Requires-Dist: gdown~=5.1; extra == "heim"
+Requires-Dist: diffusers~=0.24.0; extra == "heim"
+Requires-Dist: icetk~=0.0.4; extra == "heim"
+Requires-Dist: jax~=0.4.13; extra == "heim"
+Requires-Dist: jaxlib~=0.4.13; extra == "heim"
+Requires-Dist: crfm-helm[openai]; extra == "heim"
+Requires-Dist: einops~=0.7.0; extra == "heim"
+Requires-Dist: omegaconf~=2.3.0; extra == "heim"
+Requires-Dist: pytorch-lightning~=2.0.5; extra == "heim"
+Requires-Dist: flax~=0.6.11; extra == "heim"
+Requires-Dist: ftfy~=6.1.1; extra == "heim"
+Requires-Dist: Unidecode~=1.3.6; extra == "heim"
+Requires-Dist: wandb~=0.16; extra == "heim"
+Requires-Dist: google-cloud-translate~=3.11.2; extra == "heim"
+Requires-Dist: autokeras~=1.0.20; extra == "heim"
+Requires-Dist: clip-anytorch~=2.5.0; extra == "heim"
+Requires-Dist: google-cloud-storage~=2.9; extra == "heim"
+Requires-Dist: lpips~=0.1.4; extra == "heim"
+Requires-Dist: multilingual-clip~=1.0.10; extra == "heim"
+Requires-Dist: NudeNet~=2.0.9; extra == "heim"
+Requires-Dist: opencv-python<4.8.2.0,>=4.7.0.68; extra == "heim"
+Requires-Dist: pytorch-fid~=0.3.0; extra == "heim"
+Requires-Dist: tensorflow~=2.11; extra == "heim"
+Requires-Dist: timm~=0.6.12; extra == "heim"
+Requires-Dist: torch-fidelity~=0.3.0; extra == "heim"
+Requires-Dist: torchmetrics~=0.11.1; extra == "heim"
+Requires-Dist: scikit-image!=0.23.*,==0.*,>=0.22; extra == "heim"
+Requires-Dist: crfm-helm[images]; extra == "heim"
+Provides-Extra: medhelm
+Requires-Dist: crfm-helm[summarization]; extra == "medhelm"
+Requires-Dist: python-docx~=1.1.2; extra == "medhelm"
+Requires-Dist: langchain~=0.3.9; extra == "medhelm"
+Requires-Dist: lxml~=5.3.0; extra == "medhelm"
+Provides-Extra: audiolm
+Requires-Dist: crfm-helm[openai]; extra == "audiolm"
+Requires-Dist: crfm-helm[google]; extra == "audiolm"
+Requires-Dist: pydub~=0.25.1; extra == "audiolm"
+Requires-Dist: ffmpeg-python~=0.2.0; extra == "audiolm"
+Requires-Dist: soundfile~=0.12; extra == "audiolm"
+Requires-Dist: librosa~=0.10; extra == "audiolm"
+Requires-Dist: einops~=0.7.0; extra == "audiolm"
+Requires-Dist: openai-whisper==20240930; extra == "audiolm"
+Requires-Dist: transformers~=4.45.1; extra == "audiolm"
+Requires-Dist: transformers_stream_generator~=0.0.4; extra == "audiolm"
+Requires-Dist: scipy~=1.10; extra == "audiolm"
+Requires-Dist: torchvision<3.0.0,>=0.14.1; extra == "audiolm"
+Requires-Dist: pycocoevalcap~=1.2; extra == "audiolm"
+Requires-Dist: jiwer~=3.0; extra == "audiolm"
+Requires-Dist: rapidfuzz~=3.10; extra == "audiolm"
+Requires-Dist: jieba~=0.42.1; extra == "audiolm"
+Provides-Extra: all
+Requires-Dist: crfm-helm[proxy-server]; extra == "all"
+Requires-Dist: crfm-helm[human-evaluation]; extra == "all"
+Requires-Dist: crfm-helm[scenarios]; extra == "all"
+Requires-Dist: crfm-helm[metrics]; extra == "all"
+Requires-Dist: crfm-helm[plots]; extra == "all"
+Requires-Dist: crfm-helm[decodingtrust]; extra == "all"
+Requires-Dist: crfm-helm[slurm]; extra == "all"
+Requires-Dist: crfm-helm[cleva]; extra == "all"
+Requires-Dist: crfm-helm[images]; extra == "all"
+Requires-Dist: crfm-helm[models]; extra == "all"
+Requires-Dist: crfm-helm[mongo]; extra == "all"
+Requires-Dist: crfm-helm[heim]; extra == "all"
+Requires-Dist: crfm-helm[vlm]; extra == "all"
+Requires-Dist: crfm-helm[audiolm]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest~=7.2.0; extra == "dev"
+Requires-Dist: pre-commit~=2.20.0; extra == "dev"
+Requires-Dist: black==24.3.0; extra == "dev"
+Requires-Dist: mypy==1.5.1; extra == "dev"
+Requires-Dist: flake8==5.0.4; extra == "dev"
+Dynamic: license-file
+
+# Holistic Evaluation of Language Models (HELM)
+
+
+<a href="https://github.com/stanford-crfm/helm">
+    <img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/stanford-crfm/helm">
+</a>
+<a href="https://github.com/stanford-crfm/helm/graphs/contributors">
+    <img alt="GitHub contributors" src="https://img.shields.io/github/contributors/stanford-crfm/helm">
+</a>
+<a href="https://github.com/stanford-crfm/helm/actions/workflows/test.yml?query=branch%3Amain">
+    <img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/stanford-crfm/helm/test.yml">
+</a>
+<a href="https://crfm-helm.readthedocs.io/en/latest/">
+    <img alt="Documentation Status" src="https://readthedocs.org/projects/helm/badge/?version=latest">
+</a>
+<a href="https://github.com/stanford-crfm/helm/blob/main/LICENSE">
+    <img alt="License" src="https://img.shields.io/github/license/stanford-crfm/helm?color=blue" />
+</a>
+<a href="https://pypi.org/project/crfm-helm/">
+    <img alt="PyPI" src="https://img.shields.io/pypi/v/crfm-helm?color=blue" />
+</a>
+
+[comment]: <> (When using the img tag, which allows us to specify size, src has to be a URL.)
+<img src="https://github.com/stanford-crfm/helm/raw/v0.5.4/helm-frontend/src/assets/helm-logo.png" alt="HELM logo"  width="480"/>
+
+**Holistic Evaluation of Language Models (HELM)** is an open source Python framework created by the [Center for Research on Foundation Models (CRFM) at Stanford](https://crfm.stanford.edu/) for holistic, reproducible and transparent evaluation of foundation models, including large language models (LLMs) and multimodal models. This framework includes the following features:
+
+- Datasets and benchmarks in a standardized format (e.g. MMLU-Pro, GPQA, IFEval, WildBench)
+- Models from various providers accessible through a unified interface (e.g. OpenAI models, Anthropic Claude, Google Gemini)
+- Metrics for measuring various aspects beyond accuracy (e.g. efficiency, bias, toxicity)
+- Web UI for inspecting individual prompts and responses
+- Web leaderboard for comparing results across models and benchmarks
+
+## Documentation
+
+Please refer to [the documentation on Read the Docs](https://crfm-helm.readthedocs.io/) for instructions on how to install and run HELM.
+
+## Quick Start
+
+<!--quick-start-begin-->
+
+Install the package from PyPI:
+
+```sh
+pip install crfm-helm
+```
+
+Run the following in your shell:
+
+```sh
+# Run benchmark
+helm-run --run-entries mmlu:subject=philosophy,model=openai/gpt2 --suite my-suite --max-eval-instances 10
+
+# Summarize benchmark results
+helm-summarize --suite my-suite
+
+# Start a web server to display benchmark results
+helm-server --suite my-suite
+```
+
+Then go to http://localhost:8000/ in your browser.
+
+<!--quick-start-end-->
+
+## Leaderboards
+
+We maintain offical leaderboards with results from evaluating recent models on notable benchmarks using this framework. Our current flagship leaderboards are:
+
+- [HELM Capabilities](https://crfm.stanford.edu/helm/capabilities/latest/)
+- [HELM Safety](https://crfm.stanford.edu/helm/safety/latest/)
+- [Holistic Evaluation of Vision-Language Models (VHELM)](https://crfm.stanford.edu/helm/vhelm/latest/)
+
+We also maintain leaderboards for a diverse range of domains (e.g. medicine, finance) and aspects (e.g. multi-linguality, world knowledge, regulation compliance). Refer to the [HELM website](https://crfm.stanford.edu/helm/) for a full list of leaderboards.
+
+## Papers
+
+The HELM framework was used in the following papers for evaluating models.
+
+- **Holistic Evaluation of Language Models** - [paper](https://openreview.net/forum?id=iO4LZibEqW), [leaderboard](https://crfm.stanford.edu/helm/classic/latest/)
+- **Holistic Evaluation of Vision-Language Models (VHELM)** - [paper](https://arxiv.org/abs/2410.07112), [leaderboard](https://crfm.stanford.edu/helm/vhelm/latest/), [documentation](https://crfm-helm.readthedocs.io/en/latest/vhelm/)
+- **Holistic Evaluation of Text-To-Image Models (HEIM)** - [paper](https://arxiv.org/abs/2311.04287), [leaderboard](https://crfm.stanford.edu/helm/heim/latest/), [documentation](https://crfm-helm.readthedocs.io/en/latest/heim/)
+- **Image2Struct: Benchmarking Structure Extraction for Vision-Language Models** - [paper](https://arxiv.org/abs/2410.22456)
+- **Enterprise Benchmarks for Large Language Model Evaluation** - [paper](https://arxiv.org/abs/2410.12857), [documentation](https://crfm-helm.readthedocs.io/en/latest/enterprise_benchmark/)
+- **The Mighty ToRR: A Benchmark for Table Reasoning and Robustness** - [paper](https://arxiv.org/abs/2502.19412)
+- **Reliable and Efficient Amortized Model-based Evaluation** - [paper](https://arxiv.org/abs/2503.13335), [documentation](https://crfm-helm.readthedocs.io/en/latest/reeval/)
+
+The HELM framework can be used to reproduce the published model evaluation results from these papers. To get started, refer to the documentation links above for the corresponding paper, or the [main Reproducing Leaderboards documentation](https://crfm-helm.readthedocs.io/en/latest/reproducing_leaderboards/).
+
+## Citation
+
+If you use this software in your research, please cite the [Holistic Evaluation of Language Models paper](https://openreview.net/forum?id=iO4LZibEqW) as below.
+
+```bibtex
+@article{
+liang2023holistic,
+title={Holistic Evaluation of Language Models},
+author={Percy Liang and Rishi Bommasani and Tony Lee and Dimitris Tsipras and Dilara Soylu and Michihiro Yasunaga and Yian Zhang and Deepak Narayanan and Yuhuai Wu and Ananya Kumar and Benjamin Newman and Binhang Yuan and Bobby Yan and Ce Zhang and Christian Alexander Cosgrove and Christopher D Manning and Christopher Re and Diana Acosta-Navas and Drew Arad Hudson and Eric Zelikman and Esin Durmus and Faisal Ladhak and Frieda Rong and Hongyu Ren and Huaxiu Yao and Jue WANG and Keshav Santhanam and Laurel Orr and Lucia Zheng and Mert Yuksekgonul and Mirac Suzgun and Nathan Kim and Neel Guha and Niladri S. Chatterji and Omar Khattab and Peter Henderson and Qian Huang and Ryan Andrew Chi and Sang Michael Xie and Shibani Santurkar and Surya Ganguli and Tatsunori Hashimoto and Thomas Icard and Tianyi Zhang and Vishrav Chaudhary and William Wang and Xuechen Li and Yifan Mai and Yuhui Zhang and Yuta Koreeda},
+journal={Transactions on Machine Learning Research},
+issn={2835-8856},
+year={2023},
+url={https://openreview.net/forum?id=iO4LZibEqW},
+note={Featured Certification, Expert Certification}
+}
+```
+
+# Tutorial
+
+This tutorial will explain how to use the HELM command line tools to run benchmarks, aggregate statistics, and visualize results.
+
+We will run two runs using the `mmlu` scenario on the `openai/gpt2` model. The `mmlu` scenario implements the **Massive Multitask Language (MMLU)** benchmark from [this paper](https://arxiv.org/pdf/2009.03300.pdf), and consists of a Question Answering (QA) task using a dataset with questions from 57 subjects such as elementary mathematics, US history, computer science, law, and more. Note that GPT-2 performs poorly on MMLU, so this is just a proof of concept. We will run two runs: the first using questions about anatomy, and the second using questions about philosophy.
+
+## Using `helm-run`
+
+`helm-run` is a command line tool for running benchmarks.
+
+To run this benchmark using the HELM command-line tools, we need to specify **run entries** that describes the desired runs. For this example, the run entries are `mmlu:subject=anatomy,model=openai/gpt2` (for anatomy) and `mmlu:subject=philosophy,model=openai/gpt2` (for philosophy).
+
+We will now use `helm-run` to execute the runs. Run this command:
+
+```sh
+helm-run --run-entries mmlu:subject=anatomy,model=openai/gpt2 mmlu:subject=philosophy,model=openai/gpt2 --suite my-suite --max-eval-instances 10
+```
+
+The meaning of the arguments are as follows:
+
+- `--run-entries` specifies the run entries from the desired runs.
+- `--suite` specifies a subdirectory under the output directory in which all the output will be placed.
+- `--max-eval-instances` limits evaluation to only *N* instances (i.e. items) from the benchmark, using a randomly shuffled order of instances.
+
+`helm-run` creates an environment directory environment and an output directory by default.
+
+-  The environment directory is `prod_env/` by default and can be set using `--local-path`. Credentials for making API calls should be added to a `credentials.conf` file in this directory.
+-  The output directory is `benchmark_output/` by default and can be set using `--output-path`.
+
+After running this command, navigate to the `benchmark_output/runs/my-suite/` directory. This should contain a two sub-directories named `mmlu:subject=anatomy,model=openai_gpt2` and `mmlu:subject=philosophy,model=openai_gpt2`. Note that the names of these sub-directories is based on the run entries we used earlier, but with `/` replaced with `_`.
+
+Each output sub-directory will contain several JSON files that were generated during the corresponding run:
+
+- `run_spec.json` contains the `RunSpec`, which specifies the scenario, adapter and metrics for the run.
+- `scenario.json` contains a serialized `Scenario`, which contains the scenario for the run and specifies the instances (i.e. inputs) used.
+- `scenario_state.json` contains a serialized `ScenarioState`, which contains every request to and response from the model.
+- `per_instance_stats.json` contains a serialized list of `PerInstanceStats`, which contains the statistics produced for the metrics for each instance (i.e. input).
+- `stats.json` contains a serialized list of `PerInstanceStats`, which contains the statistics produced for the metrics, aggregated across all instances (i.e. inputs).
+
+## Using `helm-summarize`
+
+The `helm-summarize` reads the output files of `helm-run` and computes aggregate statistics across runs. Run the following:
+
+```sh
+helm-summarize --suite my-suite
+```
+
+This reads the pre-existing files in `benchmark_output/runs/my-suite/` that were written by `helm-run` previously, and writes the following new files back to `benchmark_output/runs/my-suite/`:
+
+- `summary.json` contains a serialized `ExecutiveSummary` with a date and suite name.
+- `run_specs.json` contains the run entries for all the runs.
+- `runs.json` contains serialized list of `Run`, which contains the run path, run spec and adapter spec and statistics for each run.
+- `groups.json` contains a serialized list of `Table`, each containing information about groups in a group category.
+- `groups_metadata.json` contains a list of all the groups along with a human-readable description and a taxonomy.
+
+Additionally, for each group and group-relavent metric, it will output a pair of files: `benchmark_output/runs/my-suite/groups/latex/<group_name>_<metric_name>.tex` and `benchmark_output/runs/my-suite/groups/json/<group_name>_<metric_name>.json`. These files contain the statistics for that metric from each run within the group.
+
+## Using `helm-server`
+
+Finally, the `helm-server` command launches a web server to visualize the output files of `helm-run` and `helm-benchmark`. Run:
+
+```sh
+helm-server --suite my-suite
+```
+
+Open a browser and go to http://localhost:8000/ to view the visualization. You should see a similar view as [live website for the paper](https://crfm.stanford.edu/helm/classic/latest/), but for the data from your benchmark runs. The website has the following sections accessible from the top menu bar:
+
+- **Leaderboards** contains the leaderboards with aggregate metrics.
+- **Models** contains a list of models and their descriptions
+- **Scenarios** contains a list of scenarios and their descriptions.
+- **Predictions** contains a searchable list of runs.

crfm_helm-0.5.5/README.md

@@ -0,0 +1,104 @@
+# Holistic Evaluation of Language Models (HELM)
+
+
+<a href="https://github.com/stanford-crfm/helm">
+    <img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/stanford-crfm/helm">
+</a>
+<a href="https://github.com/stanford-crfm/helm/graphs/contributors">
+    <img alt="GitHub contributors" src="https://img.shields.io/github/contributors/stanford-crfm/helm">
+</a>
+<a href="https://github.com/stanford-crfm/helm/actions/workflows/test.yml?query=branch%3Amain">
+    <img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/stanford-crfm/helm/test.yml">
+</a>
+<a href="https://crfm-helm.readthedocs.io/en/latest/">
+    <img alt="Documentation Status" src="https://readthedocs.org/projects/helm/badge/?version=latest">
+</a>
+<a href="https://github.com/stanford-crfm/helm/blob/main/LICENSE">
+    <img alt="License" src="https://img.shields.io/github/license/stanford-crfm/helm?color=blue" />
+</a>
+<a href="https://pypi.org/project/crfm-helm/">
+    <img alt="PyPI" src="https://img.shields.io/pypi/v/crfm-helm?color=blue" />
+</a>
+
+[comment]: <> (When using the img tag, which allows us to specify size, src has to be a URL.)
+<img src="https://github.com/stanford-crfm/helm/raw/v0.5.4/helm-frontend/src/assets/helm-logo.png" alt="HELM logo"  width="480"/>
+
+**Holistic Evaluation of Language Models (HELM)** is an open source Python framework created by the [Center for Research on Foundation Models (CRFM) at Stanford](https://crfm.stanford.edu/) for holistic, reproducible and transparent evaluation of foundation models, including large language models (LLMs) and multimodal models. This framework includes the following features:
+
+- Datasets and benchmarks in a standardized format (e.g. MMLU-Pro, GPQA, IFEval, WildBench)
+- Models from various providers accessible through a unified interface (e.g. OpenAI models, Anthropic Claude, Google Gemini)
+- Metrics for measuring various aspects beyond accuracy (e.g. efficiency, bias, toxicity)
+- Web UI for inspecting individual prompts and responses
+- Web leaderboard for comparing results across models and benchmarks
+
+## Documentation
+
+Please refer to [the documentation on Read the Docs](https://crfm-helm.readthedocs.io/) for instructions on how to install and run HELM.
+
+## Quick Start
+
+<!--quick-start-begin-->
+
+Install the package from PyPI:
+
+```sh
+pip install crfm-helm
+```
+
+Run the following in your shell:
+
+```sh
+# Run benchmark
+helm-run --run-entries mmlu:subject=philosophy,model=openai/gpt2 --suite my-suite --max-eval-instances 10
+
+# Summarize benchmark results
+helm-summarize --suite my-suite
+
+# Start a web server to display benchmark results
+helm-server --suite my-suite
+```
+
+Then go to http://localhost:8000/ in your browser.
+
+<!--quick-start-end-->
+
+## Leaderboards
+
+We maintain offical leaderboards with results from evaluating recent models on notable benchmarks using this framework. Our current flagship leaderboards are:
+
+- [HELM Capabilities](https://crfm.stanford.edu/helm/capabilities/latest/)
+- [HELM Safety](https://crfm.stanford.edu/helm/safety/latest/)
+- [Holistic Evaluation of Vision-Language Models (VHELM)](https://crfm.stanford.edu/helm/vhelm/latest/)
+
+We also maintain leaderboards for a diverse range of domains (e.g. medicine, finance) and aspects (e.g. multi-linguality, world knowledge, regulation compliance). Refer to the [HELM website](https://crfm.stanford.edu/helm/) for a full list of leaderboards.
+
+## Papers
+
+The HELM framework was used in the following papers for evaluating models.
+
+- **Holistic Evaluation of Language Models** - [paper](https://openreview.net/forum?id=iO4LZibEqW), [leaderboard](https://crfm.stanford.edu/helm/classic/latest/)
+- **Holistic Evaluation of Vision-Language Models (VHELM)** - [paper](https://arxiv.org/abs/2410.07112), [leaderboard](https://crfm.stanford.edu/helm/vhelm/latest/), [documentation](https://crfm-helm.readthedocs.io/en/latest/vhelm/)
+- **Holistic Evaluation of Text-To-Image Models (HEIM)** - [paper](https://arxiv.org/abs/2311.04287), [leaderboard](https://crfm.stanford.edu/helm/heim/latest/), [documentation](https://crfm-helm.readthedocs.io/en/latest/heim/)
+- **Image2Struct: Benchmarking Structure Extraction for Vision-Language Models** - [paper](https://arxiv.org/abs/2410.22456)
+- **Enterprise Benchmarks for Large Language Model Evaluation** - [paper](https://arxiv.org/abs/2410.12857), [documentation](https://crfm-helm.readthedocs.io/en/latest/enterprise_benchmark/)
+- **The Mighty ToRR: A Benchmark for Table Reasoning and Robustness** - [paper](https://arxiv.org/abs/2502.19412)
+- **Reliable and Efficient Amortized Model-based Evaluation** - [paper](https://arxiv.org/abs/2503.13335), [documentation](https://crfm-helm.readthedocs.io/en/latest/reeval/)
+
+The HELM framework can be used to reproduce the published model evaluation results from these papers. To get started, refer to the documentation links above for the corresponding paper, or the [main Reproducing Leaderboards documentation](https://crfm-helm.readthedocs.io/en/latest/reproducing_leaderboards/).
+
+## Citation
+
+If you use this software in your research, please cite the [Holistic Evaluation of Language Models paper](https://openreview.net/forum?id=iO4LZibEqW) as below.
+
+```bibtex
+@article{
+liang2023holistic,
+title={Holistic Evaluation of Language Models},
+author={Percy Liang and Rishi Bommasani and Tony Lee and Dimitris Tsipras and Dilara Soylu and Michihiro Yasunaga and Yian Zhang and Deepak Narayanan and Yuhuai Wu and Ananya Kumar and Benjamin Newman and Binhang Yuan and Bobby Yan and Ce Zhang and Christian Alexander Cosgrove and Christopher D Manning and Christopher Re and Diana Acosta-Navas and Drew Arad Hudson and Eric Zelikman and Esin Durmus and Faisal Ladhak and Frieda Rong and Hongyu Ren and Huaxiu Yao and Jue WANG and Keshav Santhanam and Laurel Orr and Lucia Zheng and Mert Yuksekgonul and Mirac Suzgun and Nathan Kim and Neel Guha and Niladri S. Chatterji and Omar Khattab and Peter Henderson and Qian Huang and Ryan Andrew Chi and Sang Michael Xie and Shibani Santurkar and Surya Ganguli and Tatsunori Hashimoto and Thomas Icard and Tianyi Zhang and Vishrav Chaudhary and William Wang and Xuechen Li and Yifan Mai and Yuhui Zhang and Yuta Koreeda},
+journal={Transactions on Machine Learning Research},
+issn={2835-8856},
+year={2023},
+url={https://openreview.net/forum?id=iO4LZibEqW},
+note={Featured Certification, Expert Certification}
+}
+```

crfm_helm-0.5.5/docs/tutorial.md

@@ -0,0 +1,71 @@
+# Tutorial
+
+This tutorial will explain how to use the HELM command line tools to run benchmarks, aggregate statistics, and visualize results.
+
+We will run two runs using the `mmlu` scenario on the `openai/gpt2` model. The `mmlu` scenario implements the **Massive Multitask Language (MMLU)** benchmark from [this paper](https://arxiv.org/pdf/2009.03300.pdf), and consists of a Question Answering (QA) task using a dataset with questions from 57 subjects such as elementary mathematics, US history, computer science, law, and more. Note that GPT-2 performs poorly on MMLU, so this is just a proof of concept. We will run two runs: the first using questions about anatomy, and the second using questions about philosophy.
+
+## Using `helm-run`
+
+`helm-run` is a command line tool for running benchmarks.
+
+To run this benchmark using the HELM command-line tools, we need to specify **run entries** that describes the desired runs. For this example, the run entries are `mmlu:subject=anatomy,model=openai/gpt2` (for anatomy) and `mmlu:subject=philosophy,model=openai/gpt2` (for philosophy).
+
+We will now use `helm-run` to execute the runs. Run this command:
+
+```sh
+helm-run --run-entries mmlu:subject=anatomy,model=openai/gpt2 mmlu:subject=philosophy,model=openai/gpt2 --suite my-suite --max-eval-instances 10
+```
+
+The meaning of the arguments are as follows:
+
+- `--run-entries` specifies the run entries from the desired runs.
+- `--suite` specifies a subdirectory under the output directory in which all the output will be placed.
+- `--max-eval-instances` limits evaluation to only *N* instances (i.e. items) from the benchmark, using a randomly shuffled order of instances.
+
+`helm-run` creates an environment directory environment and an output directory by default.
+
+-  The environment directory is `prod_env/` by default and can be set using `--local-path`. Credentials for making API calls should be added to a `credentials.conf` file in this directory.
+-  The output directory is `benchmark_output/` by default and can be set using `--output-path`.
+
+After running this command, navigate to the `benchmark_output/runs/my-suite/` directory. This should contain a two sub-directories named `mmlu:subject=anatomy,model=openai_gpt2` and `mmlu:subject=philosophy,model=openai_gpt2`. Note that the names of these sub-directories is based on the run entries we used earlier, but with `/` replaced with `_`.
+
+Each output sub-directory will contain several JSON files that were generated during the corresponding run:
+
+- `run_spec.json` contains the `RunSpec`, which specifies the scenario, adapter and metrics for the run.
+- `scenario.json` contains a serialized `Scenario`, which contains the scenario for the run and specifies the instances (i.e. inputs) used.
+- `scenario_state.json` contains a serialized `ScenarioState`, which contains every request to and response from the model.
+- `per_instance_stats.json` contains a serialized list of `PerInstanceStats`, which contains the statistics produced for the metrics for each instance (i.e. input).
+- `stats.json` contains a serialized list of `PerInstanceStats`, which contains the statistics produced for the metrics, aggregated across all instances (i.e. inputs).
+
+## Using `helm-summarize`
+
+The `helm-summarize` reads the output files of `helm-run` and computes aggregate statistics across runs. Run the following:
+
+```sh
+helm-summarize --suite my-suite
+```
+
+This reads the pre-existing files in `benchmark_output/runs/my-suite/` that were written by `helm-run` previously, and writes the following new files back to `benchmark_output/runs/my-suite/`:
+
+- `summary.json` contains a serialized `ExecutiveSummary` with a date and suite name.
+- `run_specs.json` contains the run entries for all the runs.
+- `runs.json` contains serialized list of `Run`, which contains the run path, run spec and adapter spec and statistics for each run.
+- `groups.json` contains a serialized list of `Table`, each containing information about groups in a group category.
+- `groups_metadata.json` contains a list of all the groups along with a human-readable description and a taxonomy.
+
+Additionally, for each group and group-relavent metric, it will output a pair of files: `benchmark_output/runs/my-suite/groups/latex/<group_name>_<metric_name>.tex` and `benchmark_output/runs/my-suite/groups/json/<group_name>_<metric_name>.json`. These files contain the statistics for that metric from each run within the group.
+
+## Using `helm-server`
+
+Finally, the `helm-server` command launches a web server to visualize the output files of `helm-run` and `helm-benchmark`. Run:
+
+```sh
+helm-server --suite my-suite
+```
+
+Open a browser and go to http://localhost:8000/ to view the visualization. You should see a similar view as [live website for the paper](https://crfm.stanford.edu/helm/classic/latest/), but for the data from your benchmark runs. The website has the following sections accessible from the top menu bar:
+
+- **Leaderboards** contains the leaderboards with aggregate metrics.
+- **Models** contains a list of models and their descriptions
+- **Scenarios** contains a list of scenarios and their descriptions.
+- **Predictions** contains a searchable list of runs.