CLI e biblioteca para avaliar prompts e fazer red teaming de apps com LLMs, usando configurações declarativas e integração com CI/CD.
EleutherAI/lm-evaluation-harness
Framework unificado para executar avaliações few-shot de modelos de linguagem em dezenas de benchmarks acadêmicos padrão.
- Estrelas
- 14,275
- Forks
- 3,698
- Issues abertas
- 1,212
- Último commit
- mês passado
O que é?
lm-evaluation-harness é um framework para avaliar modelos de linguagem generativos em um amplo conjunto de benchmarks padrão. Ele implementa mais de 60 benchmarks acadêmicos, com centenas de subtarefas e variantes, e usa prompts disponíveis publicamente para permitir a comparação de resultados entre artigos.
O harness oferece suporte a vários backends de modelos, incluindo Hugging Face transformers (com adaptadores PEFT e quantização), vLLM, SGLang, modelos GGUF servidos pelo llama.cpp, ONNX Runtime, NVIDIA NeMo, Megatron-LM e APIs hospedadas, como OpenAI, Anthropic e TextSynth. Configurações com várias GPUs são atendidas por meio de paralelismo de dados com accelerate, divisão do modelo em shards e paralelismo de tensores. Tarefas e prompts são definidos em YAML, e a CLI oferece suporte a subcomandos e arquivos de configuração.
Ele também é o backend de avaliação por trás do Open LLM Leaderboard da Hugging Face. É possível adicionar tarefas, prompts e métricas personalizados e, desde a versão 2025, plugins podem registrar backends, filtros e métricas de pacotes externos.
Recursos principais
- 01Abrange mais de 60 benchmarks acadêmicos padrão de LLMs, com centenas de subtarefas.
- 02Oferece suporte aos backends Hugging Face transformers, vLLM, SGLang, llama.cpp, ONNX Runtime e NeMo.
- 03Avalia modelos hospedados da OpenAI, Anthropic, TextSynth e outros provedores de API.
- 04Permite avaliações com várias GPUs usando paralelismo de dados, divisão do modelo em shards e paralelismo de tensores.
- 05Define tarefas e prompts em YAML e executa-os pela CLI ou pela API Python.
- 06Permite adicionar tarefas, métricas e backends de modelos personalizados por configuração ou plugins.
Casos de uso
- Comparar um modelo recém-treinado ou ajustado com tarefas acadêmicas padrão.
- Reproduzir resultados de avaliações publicados usando os mesmos prompts dos artigos.
- Comparar modelos quantizados, adaptados com LoRA ou hospedados localmente com APIs hospedadas usando uma configuração unificada.
- Executar avaliações de regressão na CI quando os checkpoints do modelo mudarem.
Início rápido
- 1
Clone o repositório
git clone --depth 1 https://github.com/EleutherAI/lm-evaluation-harness - 2
Entre no diretório do projeto e instale o pacote em modo editável
cd lm-evaluation-harness && pip install -e . - 3
Instale o backend de modelos do HuggingFace
pip install "lm_eval[hf]" - 4
Avalie um modelo do HuggingFace no hellaswag
lm_eval --model hf --model_args pretrained=EleutherAI/gpt-j-6B --tasks hellaswag --device cuda:0 --batch_size 8
Antes de usar
- Backends de modelos como HuggingFace ou vLLM precisam ser instalados separadamente, e o exemplo de execução pressupõe o uso de uma GPU CUDA.
Tópicos
Perguntas frequentes
- O que é lm-evaluation-harness?
- Framework unificado para executar avaliações few-shot de modelos de linguagem em dezenas de benchmarks acadêmicos padrão. lm-evaluation-harness é um framework para avaliar modelos de linguagem generativos em um amplo conjunto de benchmarks padrão. Ele implementa mais de 60 benchmarks acadêmicos, com centenas de subtarefas e variantes, e usa prompts disponíveis publicamente para permitir a comparação de resultados entre artigos.
- lm-evaluation-harness é gratuito? Qual é a licença?
- lm-evaluation-harness é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- lm-evaluation-harness ainda é mantido?
- Atualizado nos últimos 6 meses. O último commit de lm-evaluation-harness foi em 14 de set. de 2026.
- Para que posso usar lm-evaluation-harness?
- Comparar um modelo recém-treinado ou ajustado com tarefas acadêmicas padrão. Reproduzir resultados de avaliações publicados usando os mesmos prompts dos artigos. Comparar modelos quantizados, adaptados com LoRA ou hospedados localmente com APIs hospedadas usando uma configuração unificada. Executar avaliações de regressão na CI quando os checkpoints do modelo mudarem.
- Como instalar lm-evaluation-harness?
- Clone o repositório: git clone --depth 1 https://github.com/EleutherAI/lm-evaluation-harness Entre no diretório do projeto e instale o pacote em modo editável: cd lm-evaluation-harness && pip install -e . Instale o backend de modelos do HuggingFace: pip install "lm_eval[hf]" Avalie um modelo do HuggingFace no hellaswag: lm_eval --model hf --model_args pretrained=EleutherAI/gpt-j-6B --tasks hellaswag --device cuda:0 --batch_size 8
- Onde consigo lm-evaluation-harness?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/EleutherAI/lm-evaluation-harness
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Framework Python open source para testes unitários de apps com LLM, com métricas para RAG, agentes, chatbots, agentes de voz e mais, na linha do Pytest.
Biblioteca de tokenização de ponta e rápida, escrita em Rust, com bindings para Python e Node.js para pipelines de NLP e modelos de linguagem.
Benchmark e ferramenta de avaliação que verifica se modelos de linguagem conseguem resolver issues reais do GitHub gerando patches validados no Docker.
Um modelo aberto de visão e linguagem médica que processa textos médicos, imagens 2D, volumes de CT/MRI 3D e vídeos cirúrgicos, treinado com dados públicos.
Framework de RL em Python que treina agentes LLM em várias etapas com base na própria experiência, usando GRPO e uma arquitetura cliente-servidor que se integra a apps existentes.