v0 is considered deprecated and will be fully removed in a future release.
Verifiers is our library for creating environments to train and evaluate LLMs.
Environments contain everything required to run and evaluate a model on a particular task:
- A dataset of task inputs
- A harness for the model (tools, sandboxes, context management, etc.)
- A reward function or rubric to score the model’s performance
Environments can be used for training models with reinforcement learning (RL), evaluating capabilities, generating synthetic data, experimenting with agent harnesses, and more.
Verifiers is tightly integrated with the Environments Hub, as well as our training framework prime-rl and our Hosted Training platform.
Getting Started
Ensure you have uv installed, as well as the prime CLI tool:
To set up a new workspace for developing environments, do:
This sets up a Python project if needed (with uv init), installs verifiers (with uv add verifiers), creates the recommended workspace structure, and downloads useful starter files:
Alternatively, add verifiers to an existing project:
Optional features are installed with extras:
Environments built with Verifiers are self-contained Python modules. To initialize a fresh environment template, do:
This will create a new module called my_env with a runnable environment template.
Environment modules should expose a load_environment function which returns an environment object. For simple legacy environments, this can still be a direct constructor:
To run a local evaluation with any OpenAI-compatible model, do:
Evaluations use Prime Inference by default; configure your own API endpoints in ./configs/endpoints.toml.
View local evaluation results in the terminal UI:
The TUI opens a single run browser (environment -> model -> run). Press Enter on a run to open rollout details, b to go back, tab to cycle panes, e and x to expand or collapse history, pageup and pagedown to scroll history, and c for Copy Mode.
To publish the environment to the Environments Hub, do:
To run an evaluation directly from the Environments Hub, do:
Documentation
Environments — Create datasets, rubrics, and custom multi-turn interaction protocols.
Evaluation - Evaluate models using your environments.
Training — Train models in your environments with reinforcement learning.
Development — Contributing to verifiers
API Reference — Understanding the API and data structures
FAQs - Other frequently asked questions.