Zero-Shot Replication Framework

Overview

The Zero-Shot Replication Framework is a tool designed to replicate zero-shot results from recent academic papers or model reports. Additionally, it aims to extend evaluations to better understand the strengths and weaknesses of various approaches. The framework currently supports OpenAI, Anthropic, and HuggingFace models.

Features

• Simple model and parameter configuration.
• Choice of datasets for evaluation.
• Extensibility through a modular provider / model / dataset setup.

pass@1 results (all proprietary models accessed on 08/24-08/25, 2023)

To better understand these results, please check the notes below

Proprietary Models

OpenSource Models (vs latest GPT-4)

Notes on Results

• Our modified prompting for HumanEval may differ from other benchmarks.
• The GPT-4 LeetCodeSparks baseline is approximate. We don't have a precise list of LeetCode problems from the referenced reports.
• We define 'LeetCodeSparks' as the 84 problems used for the human evaluation measurement mentioned in [2].
• 'LeetCode_100' is our out-of-sample dataset, introducing 100 recent easy, medium, and hard LeetCode problems ranging from 2554-2818.

Installation

# Repository setup
git clone https://github.com/your-username/zero-shot-replication.git
cd zero-shot-replication
git submodule update --init --recursive
# Install dependencies
poetry install

Optional Dependencies

• vllm_support: For VLLM functionalities, required for WizardCoder model.
• automata: For automata agent evaluations.
• python-leetcode: For leetcode evaluations.
• evalplus: For HumanEval and HumanEval+ evaluations.
• quantized_support: For running 4 or 8 bit models.

Possible Weirdness

I sometimes see that setting torch==2.0.1 results in issues with the cuda environment initialization on my remote machine. One workaround was to first install torch=2.0.0, which requires commenting out of vllm, and to then increment the torch version and uncoment vllm. This may solve some user issues.

Requirements

• Python >= 3.11 and < 3.12
• Poetry for package management

Optional Feature Requirements

For additional features, you can install the optional dependencies:

poetry install -E <extra_name>

• WizardCode Model Gen.: vllm_support
• Phind Model Gen.: transformers must be installed from git (currently by hand)
• Automata Agent Gen.: automata
• Leetcode Evaluation: python-leetcode

Usage

You can run the zero-shot replication by executing the runner.py file with various command-line arguments.

poetry run python runner.py --provider openai --dataset human-eval --model gpt-4-0613 --temperature 0.7

Command-Line Arguments

• --provider: Which provider to use for zero-shot completions (default: "openai").
• --dataset: Which dataset to run on (default: "human-eval").
• --model: Model name to load from the provider (default: "gpt-3.5-turbo").
• --temperature: Temperature parameter for the provided model (default: 0.7).
• --output_file_name: Filename to override the default output file name with.

To see explicit commands ran to generate the reported results, check out the commands.md menu.

License

This project is licensed under the Apache-2.0 License.

Sources

[1] GPT-4 Technical Report

[2] Sparks of Artificial General Intelligence

[3] Solving Challenging Math Word Problems Using GPT-4 Code Interpreter with Code-based Self-Verification