Features
- Supports over 60 standard academic benchmarks for LLMs, with hundreds of subtasks and variants implemented.
- Compatible with commercial APIs.
- Supports local models and custom benchmarks.
- Uses publicly available prompts to ensure reproducibility and comparability between papers.
- Easy integration of custom prompts and evaluation metrics.
Prerequisites
- Python 3.9 or later
- Git
Setup
1
Create a SambaCloud account
Create a SambaCloud account and obtain an API key.
2
Clone the repository
3
Create and activate a virtual environment
4
Install dependencies
Additional Python packages may be required depending on the selected benchmark or task. If you encounter errors related to missing libraries, install them manually.
5
Set your API key
Example use case
- Example benchmark: GSM8K (Grade School Math)
- Model source: SambaCloud
Meta-Llama-3.3-70B-Instruct with any model ID from the SambaCloud models page.
Resources
Troubleshooting
Authentication error or SAMBANOVA_API_KEY not recognized
Authentication error or SAMBANOVA_API_KEY not recognized
Confirm the variable is exported in your current shell:Re-export if empty:
export SAMBANOVA_API_KEY="your-api-key". Verify the key is active in the SambaCloud portal.Task not found
Task not found
Check available task names with:Confirm you installed the
[api] extras: pip install -e ."[api]".Missing library errors during evaluation
Missing library errors during evaluation
Some benchmarks require additional packages. Install them as reported in the error, for example:

