NeMo Gym

August 3, 2026 · View on GitHub

PyPI Python License CI Docs

RequirementsQuick StartEnvironment TutorialsAvailable EnvironmentsDocumentation & ResourcesCommunity & SupportCitations

NeMo Gym is a library for evaluating and improving models and agents using environments. NeMo Gym provides infrastructure to develop environments, scalably run evaluation and training, and a collection of popular benchmarks and training environments.

An environment is the complete system an agent interacts with to complete a task. It consists of a dataset (tasks to solve), an agent harness (how the model interacts with the world), a verifier (task completion scoring), and state (per-task execution context).

🎯 When to Use NeMo Gym

  • You need to evaluate models or agents in stateful environments (e.g. code execution, tool calling, sandboxes)
  • You want reproducible evaluation across teams using shared environments and verifiers
  • You need to use environments at scale — multiple repeats per task, or thousands of concurrent requests for training
  • You want to seamlessly transition between evaluation, agent optimization, and training

If you're scoring model outputs with a stateless check and don't need scale or training, a script is probably sufficient.

🏆 What NeMo Gym Provides

  • Modular, extensible interfaces for agents, environments, tasks, and verifiers
  • Environment hub of popular benchmarks and training environments
  • Use your own agents or choose from built-in harnesses
  • Scale to thousands of concurrent environments
  • Train with the RL framework of your choice
  • Battle-tested in production Nemotron training

NeMo Gym Product Overview

🌎 Ecosystem

NeMo Gym is a component of NVIDIA NeMo, a GPU-accelerated platform for training generative AI models and optimizing AI agents. NeMo Gym is integrated with the broader agentic ecosystem - see the Ecosystem page for more details.

Environment Libraries: Seamlessly combine environments and benchmarks from other libraries alongside NeMo Gym environments. Examples: AviaryHarborOpenEnvReasoning GymVerifiers

Training Framework Libraries: Use environments for SFT and RL training. NeMo RLUnslothVeRL

Agent Harnesses: Agent harnesses for evaluation and training available out of the box. Examples: OpenHandsMini SWE AgentLangGraph

Important

NeMo Gym is currently in early development. You should expect evolving APIs, incomplete documentation, and occasional bugs. We welcome contributions and feedback - for any changes, please open an issue first to kick off discussion!

📣 News

  • [07/01/2026] Release v0.4.0:
    • Unified gym CLI: discover agents and benchmarks with gym list, catch config errors before a run with gym env validate
    • BLADE diagnostics: an analysis skill that reads your eval results and reports which tasks failed, why, and the highest-impact fix
    • Agent skill evaluation: run the same tasks with different skill sets to measure each skill's impact
    • Pluggable sandboxes: run tool-using agents in isolated environments via the sandbox provider of your choice
    • More agent harnesses: OpenCode, OpenClaw, and Pi available out of the box
    • Hosted inference providers: connect to Fireworks, Together.ai, OpenRouter, and more
    • New benchmarks: across science, long-context, and interactive tasks
Previous News
  • [06/04/2026] Release v0.3.0!: 70+ new environments, Nemotron 3 Ultra training datasets, VeRL integration, and out-of-the-box harnesses including Claude Code and Hermes.

📋 Requirements

NeMo Gym is designed to run on standard development machines:

Hardware RequirementsSoftware Requirements
GPU: Not required for NeMo Gym library operation
• GPU may be needed for specific resources servers or model inference (see individual server documentation)
Operating System:
• Linux (Ubuntu 20.04+, or equivalent)
• macOS (11.0+ for x86_64, 12.0+ for Apple Silicon)
• Windows (via WSL2)
CPU: Any modern x86_64 or ARM64 processor (e.g., Intel, AMD, Apple Silicon)Python: 3.12 or higher
RAM: Minimum 8 GB (16 GB+ recommended for larger environments)Git: For cloning the repository
Storage: Minimum 5 GB free disk space for installation and basic usageInternet Connection: Required for downloading dependencies and API access

Additional Requirements

  • API Keys: OpenAI API key with available credits (for the quickstart examples)
    • Other model providers supported (Azure OpenAI, self-hosted models via vLLM)
  • Ray: Automatically installed as a dependency (no separate setup required)

🚀 Quick Start

Requires Python 3.12+ on x86_64 or ARM64 (Linux, macOS, Windows via WSL2). No GPU required. See the Getting Started docs for a more comprehensive walkthrough.

Install NeMo Gym:

Requires uv and Python 3.12+.

git clone git@github.com:NVIDIA-NeMo/Gym.git
cd Gym
uv venv --python 3.12 && source .venv/bin/activate
uv sync

Configure your model:

This quickstart uses OpenAI. NeMo Gym supports local and hosted inference — see Configure Model for vLLM, Fireworks, OpenRouter, and others.

Create env.yaml in the project root:

policy_base_url: https://api.openai.com/v1
policy_api_key: <your-openai-api-key>
policy_model_name: gpt-4.1-2025-04-14

Run Evaluation

Run your agent on a set of tasks and score the results. This example uses a simple tool calling agent simple_agent with the mcqa (multiple-choice Q&A) environment and its included example data.

1. Start servers

NeMo Gym uses local servers to coordinate your model, agent, and task verification. Start them first:

gym env start \
    --resources-server mcqa \
    --model-type openai_model

You should see three server instances starting:

[1] mcqa (resources_servers/mcqa)
[2] mcqa_simple_agent (responses_api_agents/simple_agent)
[3] policy_model (responses_api_models/openai_model)

2. Evaluate your agent

In a new terminal, run your agent on a single task to verify everything works:

source .venv/bin/activate

gym eval run --no-serve \
    --agent mcqa_simple_agent \
    --input resources_servers/mcqa/data/example.jsonl \
    --output results/mcqa_rollouts.jsonl \
    --limit 5 \
    --num-repeats 1

You should see a progress bar followed by aggregate metrics:

Collecting rollouts: 100%|██████| 5/5 [01:22<00:00, 16.44s/it]

Key metrics for mcqa_simple_agent:
{
    "mean/reward": 0.8,
    "pass@1[avg-of-1]/accuracy": 80.0,
    "pass@1/accuracy": 80.0
}
Finished rollout collection! View results at:
Fully materialized inputs: results/mcqa_rollouts_materialized_inputs.jsonl
Rollouts: results/mcqa_rollouts.jsonl
Aggregate metrics: results/mcqa_rollouts_aggregate_metrics.json

For per-task pass rates, see the gym eval profile command.

Next Steps

  • Browse Environments — Browse available environments for evaluation and training.
  • Agents — Explore available agent harnesses and learn how to integrate your own.
  • Training — Improve your agent or model with RL or fine-tuning.
  • Build Custom Environments — Create your own evaluation or training environments.

🧭 Environment Tutorials

Learn how to build custom environments through hands-on tutorials. Here are popular starting points:

NameDemonstrates
Single StepBasic single-step tool calling
Multi StepMulti-step tool calling
Session StateSession state management (in-memory)
Multi RewardMultiple reward components for evaluation and multi-objective RL (e.g. GDPO)

See all environment tutorials for additional patterns and advanced topics.

📦 Available Environments

Environments for training and evaluation.

Each resources server includes example data, configuration files, and tests. See each server's README for details.

The Dataset column links to publicly available datasets (e.g., on HuggingFace). A - means the train/validation data has not been publicly released yet, or that it is procedurally generated using a provided script. If no data is released yet, new data can be generated, or the environment can be used as a reference. Each server includes 5 example tasks in data/example.jsonl.

EnvironmentDomainDescriptionValueTrainValidationLicenseConfigDataset
Aalcrother-----aalcr.yaml-
AbstentionrlhfTrain models to abstain when unsure using three-tier reward on HotPotQA with LLM judgeImprove calibration by rewarding abstention over incorrect answersCreative Commons Attribution-ShareAlike 4.0 Internationalabstention.yaml-
Anyswe AgentcodingSWE-bench run by Claude Code natively inside the task container.Eval software engineering capabilities on SWE-bench with any Gym agent.---anyswe_claude_code.yaml-
Anyswe AgentcodingSWE-bench run by Hermes Agent natively inside the task container.Eval software engineering capabilities on SWE-bench with any Gym agent.---anyswe_hermes.yaml-
Anyswe AgentcodingSWE-bench run by OpenClaw natively inside the task container.Eval software engineering capabilities on SWE-bench with any Gym agent.---anyswe_openclaw.yaml-
Anyswe AgentcodingSWE-bench run by OpenCode inside the task container.Eval software engineering capabilities on SWE-bench with any Gym agent.---anyswe_opencode.yaml-
Anyswe AgentcodingSWE-bench run by Pi inside the task container.Eval software engineering capabilities on SWE-bench with any Gym agent.---anyswe_pi.yaml-
Anyterminal AgentcodingTerminal Bench run by claude-code natively inside the task container.Evaluate terminal-task capabilities on Terminal Bench with any Gym agent.---anyterminal_claude_code.yaml-
Anyterminal AgentcodingTerminal Bench run by the Hermes agent inside the task container.Evaluate terminal-task capabilities on Terminal Bench with any Gym agent.---anyterminal_hermes.yaml-
Arc AgiknowledgeSolve puzzles designed to test intelligence. See https://arcprize.org/arc-agi.Improve puzzle-solving capabilities.--arc_agi.yaml-
Arena Judge-----arena_judge.yaml-
Asr With PcotherASR with WER scoring (standard, case-sensitive, punctuation+capitalization)Improve transcription quality with structural detail---asr_with_pc.yaml-
AviaryagentMulti-hop question answering on the HotPotQA dataset with Wikipedia searchImprove knowledge and agentic capabilityApache 2.0hotpotqa_aviary.yaml-
AviarymathGSM8k benchmark with calculator toolTest math and agentic capabilityApache 2.0gsm8k_aviary.yaml-
BigcodebenchcodingVerifies model-generated Python solutions against the BigCodeBench unittest suite.Improve practical, library-rich Python coding capabilities.---bigcodebench.yaml-
Bird SqlcodingText-to-SQL with execution-based evaluation on BIRD dev (1534 SQLite tasks). Binary reward from unordered result-set equality.Improve text-to-SQL capabilities on BIRD's realistic dev split using execution-based binary reward without an LLM judge.---bird_sql.yaml-
BlackjackgamesBlackjack. Model hits or stands. Reward +1 win, 0 draw, -1 loss/bust.Example gymnasium-style multi-step environment---blackjack.yaml-
Browsecomp Advanced HarnessagentModel uses search tools to satisfy a user query.Measure agentic search capability---browsecomp_advanced_harness.yaml-
Bunsenbench Chemistry McqknowledgePublic BunsenBench chemistry multiple-choice benchmark verifierMeasure chemistry MCQ reasoning with source and taxonomy breakdowns---bunsenbench_chemistry_mcq.yaml-
CalendaragentMulti-turn calendar scheduling dataset. User states events and constraints in natural language; model schedules events to satisfy all constraints.Improve multi-turn instruction following capabilitiesApache 2.0calendar.yamlNemotron-RL-agent-calendar_scheduling
CalendaragentMulti-turn calendar scheduling dataset. User states events and constraints in natural language; model schedules events to satisfy all constraints.Improve multi-turn instruction following capabilitiesCreative Commons Attribution 4.0 Internationalcalendar_v2.yamlNemotron-RL-Instruction-Following-Calendar-v2
Circle ClickotherClick on circles in imagesImprove visual grounding and spatial reasoning---circle_click.yaml-
Circle CountotherCount circles of a given color in imagesImprove visual counting and color recognition---circle_count.yaml-
Code FimcodingCode Fill-in-the-Middle judged by HumanEval-Infilling test suite (single_line, multi_line, random_span, random_span_light)Improve Python code-infilling capabilities (prefix + completion + suffix)---code_fim.yaml-
Code GencodingModel must submit the right code to solve a problemImprove competitive coding capabilitiesApache 2.0code_gen.yamlnemotron-RL-coding-competitive_coding
Competitive Coding ChallengescodingExecution of competitive programming competition questionsImprove competitive coding capabilities on contest-style problems---competitive_coding_challenges.yaml-
CritptotherResearch-level physics problems scored by the Artificial Analysis APIEvaluate model performance on research-level physics reasoning---critpt.yaml-
Equivalence Llm JudgeagentShort bash command generation questions with LLM-as-a-judgeImprove foundational bash and IF capabilitiesGNU General Public License v3.0nl2bash-equivalency.yaml-
Equivalence Llm JudgeknowledgeShort answer questions with LLM-as-a-judgeImprove knowledge-related benchmarks like GPQA / HLE---equivalence_llm_judge.yaml-
Equivalence RuleknowledgeQuestion - Answering with rule-based rewardImprove retrieval and counting capabilities---lc.yaml-
Ether0knowledgeether0 chemistry benchmark verifiersEvaluate chemistry knowledge and reasoning with ether0 benchmark--ether0.yaml-
EvalpluscodingFunction-completion code judged by EvalPlus base + plus tests (HumanEval+, MBPP+)Improve Python function-completion capabilities---evalplus.yaml-
Finance Sec SearchagentSEC EDGAR filing search for financial analysis questionsEnable LLMs to search and analyze SEC filings---finance_sec_search.yaml-
Format Verificationinstruction_followingVerify citation/reference markers in model responses via string matchingImprove instruction following for citation format adherence-Apache 2.0citation_format.yaml-
Format Verificationinstruction_followingVerify freeform text formatting (bullets, headings, tables, etc.) via regex patternsImprove instruction following for text formatting constraints-Apache 2.0freeform_formatting.yaml-
Frontierscience JudgeotherFrontierScience answer grading via single-pass LLM judgeEvaluate FrontierScience Olympiad short answers or Research rubric-scored answers---frontierscience_judge.yaml-
Genrm ComparerlhfGenRM pairwise comparison for RLHF trainingCompare multiple candidate responses using GenRM model---genrm_compare.yaml-
Google SearchagentMulti-choice question answering problems with search tools integratedImprove knowledge-related benchmarks with search tools-Apache 2.0google_search.yamlNemotron-RL-knowledge-web_search-mcqa
Gpqa DiamondknowledgeGPQA Diamond multiple-choice question answering problemsEvaluate graduate-level scientific reasoning via MCQ verification-MITgpqa_diamond.yaml-
GraphwalksotherLong-context graph-walks (BFS / parents) with F1-over-node-sets grading from openai/graphwalksImprove long-context multi-step graph reasoning and adjacency-list traversal---graphwalks.yaml-
Grl SokobangamesSingle-box Sokoban in Gymnasium API style.Model emits one move per turn until the puzzle is solved.---grl_sokoban.yaml-
Grl TetrisgamesTetris in Gymnasium API style. Model emits one or more moves per turn.Multi-step Tetris environment---grl_tetris.yaml-
GymnasiumotherBase class for Gymnasium-style servers. Not a standalone server.Reusable base class for step/reset style environments---gymnasium.yaml-
Harbor AgentagentFast local smoketest task (trivial 1-turn task, no LLM judge) for iterating on the Gym<->Harbor bridge.---harbor_agent_smoketest_docker.yaml-
Harbor AgentagentHarbor integration for agent harnesses and environments.Improve models in popular agentic environments supported by Harbor such as Terminus2.--harbor_agent.yaml-
Harbor AgentagentHarbor integration for agent harnesses and environments.Improve models in popular agentic environments supported by Harbor such as Terminus2.--harbor_agent_daytona.yaml-
Hotpotqa QaknowledgeShort-answer QA with deterministic SQuAD-style + alternative-aware substring verification (HotpotQA closed-book).Improve closed-book multi-hop question-answering accuracy.---hotpotqa_qa.yaml-
Ifbenchinstruction_followingIFBench instruction following evaluation using AllenAI's IFBench library (57 instruction types)Improve IFBench instruction following---ifbench.yaml-
Ihevalinstruction_followingIHEval instruction-hierarchy benchmark (8 single-turn tasks — task execution, safety, tool use, rule following) scored with the upstream rule-based checkers.Improve instruction-hierarchy following across aligned/conflict/reference settings, including native tool-use trajectories.--iheval.yaml-
Imo GradingbenchmathFour-class grading of math proofs — the policy model reads a problem plus a candidate proof and emits one of correct / almost / partial / incorrect as the last word.Improve the IMO-GradingBench benchmark and proof-grading skill.---imo_gradingbench.yaml-
Imo Proofbench JudgemathIMO ProofBench grader using a strong LLM judge with the IMO 0-7 rubricScore IMO-style proof submissions with a problem-specific grading rubric---imo_proofbench_judge.yaml-
Indirect Prompt InjectionsafetyIndirect prompt injection resistance for multi-domain tool-use agentsImprove agentic security by teaching robustness against tool outputs containing malicious instructionsApache 2.0indirect_prompt_injection.yaml-
Instruction Followinginstruction_followingInstruction following datasets targeting IFEval and IFBench style instruction following capabilitiesImprove IFEval and IFBench-Apache 2.0instruction_following.yamlNemotron-RL-instruction_following
Inverse IfknowledgeInverse IF instruction-following benchmark with per-task LLM judge--TBDinverse_if.yaml-
Jailbreak DetectionsafetyJailbreak detection with Nemotron judge + combined rewardImprove Jailbreak Robustness and Safety/Security Behavior Guide Enforcement---jailbreak_detection_nemotron_combined_reward_tp8.yaml-
Labbench2 Vlmknowledgelabbench2 VLM benchmarks: scientific figure/table QA (figqa2, tableqa2), protocol troubleshooting (protocolqa2), LLM-as-judgeMeasure scientific reasoning on figures, tables, and lab protocols--labbench2_vlm.yaml-
Lc NiahknowledgeAnswer-correctness reward gated by low reasoning/input overlapReward correct answers while discouraging copying the prompt into reasoning---lc_niah.yaml-
Legal Agent BenchagentHarbor-native integration of Legal Agent Benchmark (LAB)Improve legal-agent document review, drafting, and analysis capability--legal_agent_bench.yaml-
Litmus AgentknowledgeDomain-agnostic answer verifier: extracts a model's final answer with an answer_format regex and scores it against expected_answer per an answer_type taxonomy (float, bool, string). For tool-using rows it can also host a sandbox-backed stateful Python code-execution tool.Reusable scoring for any benchmark whose tasks reduce to "match the expected answer".-Creative Commons Attribution 4.0 Internationallitmus_agent.yamlNemotron-RL-litmus-bench-v0.1
Litmus AgentknowledgeDomain-agnostic answer verifier: extracts a model's final answer with an answer_format regex and scores it against expected_answer per an answer_type taxonomy (float, bool, string). For tool-using rows it can also host a sandbox-backed stateful Python code-execution tool. This variant backs the tool with the local Apptainer provider (no service or API key); swap to litmus_agent.yaml for the OpenSandbox provider.Reusable scoring for any benchmark whose tasks reduce to "match the expected answer".-Creative Commons Attribution 4.0 Internationallitmus_agent_apptainer.yamlNemotron-RL-litmus-bench-v0.1
Longmt EvalotherDocument-level MT verifier for pg19 books using the SEGALE pipeline (ersatz segment → LASER2 embed → vecalign align → COMETKiwi score)Rewards long-form book translation at the document level using reference-free COMETKiwi scores as the RL reward signal.---longmt_pg19.yaml-
Longmt EvalotherDocument-level MT verifier for wmt24pp short docs using the SEGALE pipeline (ersatz segment → LASER2 embed → vecalign align → COMETKiwi score).Rewards document-level translation quality across 55 language pairs using reference-free COMETKiwi scores as the RL reward signal.---longmt_wmt24pp.yaml-
Longmt EvalotherDocument-level MT verifier using the SEGALE pipeline (ersatz segment → LASER2 embed → vecalign align → COMETKiwi score)Rewards long-form translation quality at the document level using reference-free COMETKiwi scores as the RL reward signal.---longmt_eval.yaml-
Math Advanced CalculationsagentAn instruction following math environment with counter-intuitive calculatorsImprove instruction following capabilities in specific math environments-Apache 2.0math_advanced_calculations.yamlNemotron-RL-math-advanced_calculations
Math Formal LeanmathLean4 formal proof verification environmentImprove formal theorem proving capabilities-Apache 2.0nemotron_clean_easy.yaml-
Math Formal LeanmathLean4 formal proof verification environmentImprove formal theorem proving capabilities-Apache 2.0nemotron_first_try_hard.yaml-
Math Formal LeanmathLean4 formal proof verification environmentImprove formal theorem proving capabilities-Apache 2.0nemotron_medium_500.yaml-
Math Formal LeanmathLean4 formal proof verification environmentImprove formal theorem proving capabilities-Apache 2.0nemotron_very_easy.yaml-
Math Formal LeanmathLean4 formal proof verification environmentImprove formal theorem proving capabilities-MITmath_formal_lean.yaml-
Math Formal LeanmathLean4 formal proof verification environment with multi-turn self-correctionImprove formal theorem proving capabilities-MITmath_formal_lean_multi_turn.yaml-
Math Proof JudgementmathBinary judgement of math proofs — the policy model reads a problem plus a candidate proof and outputs Judgement: Yes/No.Improve the NVIDIA ProofBench judge benchmark and math-proof verification skill.---math_proof_judgement.yaml-
Math With AutogradermathMath QA verified by a Skills-style autograder LLM judge with math-verify symbolic fallbackScore hard-math benchmarks (e.g. IMO AnswerBench) where the judge is a unidirectional Correct/Incorrect grader---math_with_autograder.yaml-
Math With CodemathModel solves competitive math problems using simple calculator toolsImprove math and simple tool use capabilities-Apache 2.0math_with_code.yaml-
Math With JudgemathDAPO17k math dataset with math-verifyImprove math capabilities including AIME 24 / 25Apache 2.0dapo17k.yaml-
Math With JudgemathHermes Agent with terminal, file, code_execution, skills, todo toolsets on OpenMathReasoning math dataset with math-verify and LLM-as-a-judgeImprove model math capabilities in hermes agent harness such as AIME25-Creative Commons Attribution 4.0 Internationalmath_with_judge_hermes_agent.yamlNemotron-RL-math-OpenMathReasoning
Math With JudgemathKiloCode agent harness on OpenMathReasoning math dataset with math-verifyImprove model math capabilities in the KiloCode agent harness---math_with_judge_kilocode_agent.yaml-
Math With JudgemathMathStackOverflow math dataset with math-verifyImprove math capabilities including AIME 24 / 25Creative Commons Attribution-ShareAlike 4.0 Internationalmath_stack_overflow.yamlNemotron-RL-math-stack_overflow
Math With JudgemathOpenClaw agent harness on OpenMathReasoning math dataset with math-verifyImprove model math capabilities in the OpenClaw agent harness---math_with_judge_openclaw_agent.yaml-
Math With JudgemathOpenCode agent harness on OpenMathReasoning math dataset with math-verifyImprove model math capabilities in the OpenCode agent harness---math_with_judge_opencode_agent.yaml-
Math With JudgemathOpenMathReasoning math dataset with math-verify and LLM-as-a-judgeImprove math capabilities including AIME 24 / 25Creative Commons Attribution 4.0 Internationalmath_with_judge.yamlNemotron-RL-math-OpenMathReasoning
Math With Judgemathpi agent harness on OpenMathReasoning math dataset with math-verifyImprove model math capabilities in the pi agent harness---math_with_judge_pi_agent.yaml-
McqaknowledgeMulti-choice question answering problemsImprove benchmarks like MMLU / GPQA / HLEApache 2.0mcqa.yamlNemotron-RL-knowledge-mcqa
Mini Swe AgentcodingSoftware engineering tasks driven by mini-swe agent harness.Improve agentic software engineering capabilities.MITmini_swe_agent.yamlSWE-Gym
MrcrotherMulti-round coreference resolution over multi-turn conversations with prefix-gated SequenceMatcher gradingImprove long-context in-context retrieval and needle-count-aware reasoning---mrcr.yaml-
MultichallengeknowledgeTargets inference memory, instruction retention, version editing, and self-coherence.Improve complex multi-turn conversational capability-Creative Commons Attribution 4.0 Internationalmultichallenge_nrl.yamlNemotron-RL-Instruction-Following-MultiTurnChat-v1
Newton BenchmathScientific law discovery tasks through agentic experimentation across 12 physics domainsImprove science, reasoning, and tool use capabilities-Apache 2.0newton_bench.yaml-
Ns ToolsagentNeMo Skills tool execution with math verification----ns_tools.yaml-
NvarcknowledgeARC-AGI inductive mode: model outputs Python code with transform()Improve ARC-AGI puzzle-solving by inducing executable transformation programsApache 2.0inductive.yaml-
NvarcknowledgeARC-AGI transductive mode: model outputs grid directlyImprove ARC-AGI puzzle-solving by directly predicting transformed gridsApache 2.0transductive.yaml-
OmniscienceknowledgeOmniscience factual knowledge QA with LLM judge verificationEvaluate factual recall and calibration via LLM-graded open-ended QA---omniscience.yaml-
OpenenvagentEcho environment via OpenEnv (MCP). Echoes messages back with length-based rewards.----openenv_echo.yaml-
OpenenvcodingPython code execution environment via OpenEnv. Executes code and returns stdout/stderr.----openenv_coding.yaml-
OpenenvgamesMaze navigation environment via OpenEnv. Agent navigates an 8x8 grid to find the exit.----openenv_maze.yaml-
Over Refusal Detection---TBDover_refusal_detection.yaml-
Physics JudgemathPhysics QA verified by NeMo Skills' physics judge LLM with math-verify symbolic fallbackScore open-ended physics benchmarks (e.g. PHYSICS) where the judge emits [Correct] / [Incorrect] verdicts---physics_judge.yaml-
PinchbenchagentPinchBench benchmark integrationEvaluate a model as the brain of an OpenClaw agent on real-world tasks.---pinchbench.yaml-
PolymathmathPolyMath multilingual math benchmark with weighted (difficulty) and per-language metricsImprove multilingual math reasoning across 18 languages and 4 difficulty tiers---polymath.yaml-
Proof GenselectmathPairwise proof selection with binary correctness reward----proof_genselect.yaml-
Proof JudgemathTheorem proving with verifier + meta-verifier judge (combined env)----proof_judge.yaml-
Proof VerificationmathProof verification scored against ground truth and meta-verifier agreement----proof_verification.yaml-
RagtruthknowledgeRAGTruth case-level hallucination detection; reward = 1 when the model's binary "any hallucination?" verdict matches the gold label.Improve faithfulness and grounding of generated text against supplied context.--ragtruth.yaml-
Reasoning GymknowledgeClaude Code agent harness for reasoning gym tasksEvaluate model capabilities in the Claude Code agent harness-Creative Commons Attribution 4.0 Internationalreasoning_gym_claude_code_agent.yamlNemotron-RL-ReasoningGym-v1
Reasoning GymknowledgeClaude Code agent harness for reasoning gym tasks, via a Gym model server's /v1/messagesShowcase Claude Code running against any Gym model backend---reasoning_gym_claude_code_agent_model_server.yaml-
Reasoning GymknowledgeCodex agent harness for reasoning gym tasksEvaluate model capabilities in the Codex agent harness---reasoning_gym_codex_agent.yaml-
Reasoning GymknowledgeCodex agent harness for reasoning gym tasks, via a Gym model server's /v1/responsesShowcase Codex running against any Gym model backend---reasoning_gym_codex_agent_model_server.yaml-
Reasoning GymknowledgeLangGraph orchestrator agent compatible with resource servers that do not use tools; enables diverse agent training data and test time scaling vs a simple agent, extensible to use tools or other agent architecturesIterative test time scaling for improved performance in reasoning tasks-Apache 2.0orchestrator_agent.yaml-
Reasoning GymknowledgeLangGraph parallel thinking agent compatible with resource servers that do not use tools; enables diverse agent training data and test time scaling vs a simple agent, extensible to use tools or other agent architecturesIterative test time scaling for improved performance in reasoning tasks-Apache 2.0parallel_thinking_agent.yaml-
Reasoning GymknowledgeLangGraph reflection agent compatible with resource servers that do not use tools; provides iterative reflection for diverse agent training data and test time scaling, extensible to use tools or other agent architecturesIterative test time scaling for improved performance in reasoning tasks-Apache 2.0reflection_agent.yaml-
Reasoning GymknowledgeLangGraph ReWOO agent compatible with resource servers that do not use tools; enables diverse agent training data and test time scaling vs a simple agent, extensible to use tools or other agent architecturesIterative test time scaling for improved performance in reasoning tasks-Apache 2.0rewoo_agent.yaml-
Reasoning GymknowledgeOver 100 tasks including algebra, arithmetic, computation, cognition, geometry, graph theory, logic, and many common games.Improve robustness, generalization, broad knowledge and reasoning-Creative Commons Attribution 4.0 Internationalreasoning_gym.yamlNemotron-RL-ReasoningGym-v1
Rolemrcinstruction_followingRoleMRC role-play MRC scored with reference metrics (ROUGE/BLEU/METEOR/BERTScore); ROUGE-L is the reward.Improve role-play instruction following and knowledge-grounded responses.--rolemrc.yaml-
RolemrcrlhfRoleMRC role-play MRC scored by a 5-aspect LLM-as-judge (knowledge range, style, nested/multi-turn instruction, instruction priority).Improve role-play instruction following under knowledge-range and instruction-priority constraints.--rolemrc_judge.yaml-
Rulerother-----ruler.yaml-
ScicodecodingMulti-step scientific code generation; sub-step solutions executed against SciCode test casesImprove multi-step scientific code generation---scicode.yaml-
SimpleqaknowledgeSimpleQA short-form factual QA with 3-tier LLM judge (CORRECT / INCORRECT / NOT_ATTEMPTED)Evaluate factual recall and abstention calibration via LLM-graded open-ended QA---simpleqa.yaml-
Single Step Tool Use With Argument ComparisonagentConversational tool-use RL from expert trajectories; behavior cloning per step across auth, lookup, and servicing domains.-Creative Commons Attribution 4.0 Internationalsingle_step_tool_use_with_argument_comparison.yamlNemotron-RL-Agentic-Conversational-Tool-Use-Pivot-v1
Single Step Tool Use With Argument ComparisonagentDroid agent pivot dataset; behavior cloning per step from successful Droid rollouts.----droid_pivot_single_step_tool_use_with_argument_comparison.yaml-
Single Step Tool Use With Argument ComparisonagentGeneral function-calling RL dataset using expert trajectories; behavior cloning to match expert tool calls per step.-Creative Commons Attribution 4.0 Internationaltoolcall_schema_single_step_tool_use_with_argument_comparison.yamlNemotron-RL-Agentic-Function-Calling-Pivot-v1
Single Step Tool Use With Argument ComparisonagentGitHub-issue dataset for software-engineering agents; refactored from SWE-Gym and SWE-Bench-Verified for NeMo Gym.-Creative Commons Attribution 4.0 Internationalswe_pivot_single_step_tool_use_with_argument_comparison.yamlNemotron-RL-Agentic-SWE-Pivot-v1
Single Step Tool Use With Argument ComparisonagentThe model must output the next correct call in a given trajectory involving search tools.Improve agentic search capability.Apache 2.0search_pivot_single_step_tool_use_with_argument_comparison.yaml-
Speed BenchotherSpeculative-decoding throughput benchmark. Reads vLLM /metrics Prometheus counters before/after generation to compute acceptance length and acceptance rate.Measure inference-time speculative-decoding effectiveness for serving research and regression tests.---speed_bench.yaml-
Spider2 LitecodingText-to-SQL with execution-based evaluation on Spider 2.0-Lite (135 SQLite tasks). Binary reward based on result-set equivalence.Improve text-to-SQL capabilities for real-world enterprise queries using execution-based binary reward without an LLM judge.--spider2_lite.yaml-
Structevalinstruction_followingStructEval non-renderable format verification (JSON, YAML, CSV, TOML, XML)Improve structured output generation quality-Apache 2.0structeval_nonrenderable.yaml-
Structured Outputsinstruction_followingCheck if responses are following structured output requirements in promptsImprove instruction following capabilitiesApache 2.0structured_outputs_json.yamlNemotron-RL-instruction_following-structured_outputs
Structured Outputsinstruction_followingCheck if responses are following structured output requirements in promptsImprove instruction following capabilitiesApache 2.0structured_outputs_json_yaml_xml_v1.yaml-
Structured Outputsinstruction_followingCheck if responses follow structured output requirements (JSON, YAML, XML, TOML, CSV). Created 20260409.Improve schema adherence across all structured output formats-Apache 2.0structured_outputs_v3.yaml-
Structured Outputsinstruction_followingCheck if responses follow tool-call structured output schemas. Created 20260424.Improve schema adherence when structured output is expressed through tool calls-Apache 2.0structured_outputs_v4.yaml-
Swe Agents--Apache 2.0swebench_multi_tools.yaml-
Swe Agents--Apache 2.0swebench_openhands.yaml-
Swe Agents--Apache 2.0swebench_openhands_training.yaml-
Swe AgentscodingSWE-bench driven by the opencode agent framework for RL training.Train software engineering capabilities on SWE tasks using opencode rollouts.-Apache 2.0swebench_opencode_training.yaml-
Swe AgentscodingSWE-bench driven by the opencode agent framework.Eval software engineering capabilities on SWE-bench using opencode.Apache 2.0swebench_opencode.yaml-
Swe PivotagentSWE pivot verifier for PivotRL on coding agent trajectoriesImprove coding agent fix-design decisionsApache 2.0swe_pivot.yaml-
Swerl GencodingRunning sandboxed evaluation for SWE-style tasks (either patch generation or reproduction test generation)Improve SWE capabilities useful for benchmarks like SWE-benchApache 2.0swerl_gen.yaml-
Swerl Llm JudgecodingSWE-style multiple-choice LLM-judge tasks scored via ... choice.Improve SWE capabilities useful for benchmarks like SWE-benchMITswerl_llm_judge.yaml-
TalesgamesTALES text-adventure games (textworld, textworld_express, alfworld, scienceworld, jericho) in Gymnasium API style.Multi-turn reasoning and progress through open-ended, situated text environments.---tales.yaml-
Tau2agentTau2 benchmark integrationEvaluate multi-turn agentic capability with user simulation.---tau2_agent.yaml-
Tau2agentTau2 benchmark integration with a 10-agent-step limitEvaluate multi-turn agentic capability with user simulation and a turn limit.---tau2_agent_turn_limit.yaml-
Tavily SearchagentModel uses search tools to satisfy a user query.Measure agentic search capabilityApache 2.0tavily_search_judge_vllm_model.yaml-
Terminal Multi HarnessagentAgent006 harness structured-action verifier for next-step pivot RL.----terminal_multi_harness_agent006.yaml-
Terminal Multi HarnessagentCodex harness structured-action verifier for next-step pivot RL.----terminal_multi_harness_codex.yaml-
Terminal Multi HarnessagentOpenCode harness structured-action verifier for next-step pivot RL.----terminal_multi_harness_opencode.yaml-
Terminal Multi HarnessagentStirrup harness structured-action verifier for next-step pivot RL.----terminal_multi_harness_stirrup.yaml-
Terminus Judgeagentsingle-step terminal based task (rubrics v4 judge prompt)Improve on terminal-style tasksApache 2.0terminus_judge.yaml-
Terminus Judgeagentsingle-step terminal based task (simple judge prompt)Improve on terminal-style tasksApache 2.0terminus_judge_simple.yaml-
Terminus Judgeagentsingle-step terminal based task (string similarity only)Improve on terminal-style tasksApache 2.0terminus_judge_string_only.yaml-
Text To SqlcodingText-to-SQL generation with LLM-as-a-judge equivalence checkingImprove text-to-SQL capabilities across multiple dialects---text_to_sql.yaml-
ToolsandboxagentToolSandbox multi-turn tool-use benchmark; reward is the milestone similarity in [0, 1] (0 if a minefield is hit).Improve stateful, multi-turn tool-calling and user-interaction capability.--toolsandbox.yaml-
Ugphysics JudgeknowledgeUndergraduate physics QA verified by a TRUE/FALSE LLM judge with math-verify symbolic fallbackScore undergraduate-physics benchmarks (e.g. UGPhysics) where the judge is a TRUE/FALSE equivalence grader using a reference solution---ugphysics_judge.yaml-
Verifiers AgentmathPrime intellect verifiers and environments hub integration, ace-reason math environment example.Improve math reasoning capabilities.--acereason-math.yaml-
Verififinstruction_followingVerifIF instruction following validators with rule-based and LLM judge supportImprove instruction following capabilities with comprehensive validation---verifif.yaml-
Vlm Eval Kitother-Measure VLM capabilities--MMBench_DEV_EN_V11.yaml-
Vlm Eval Kitother-Measure VLM capabilities--OCRBench.yaml-
Vlm Eval KitotherRun all supported VLMEvalKit benchmarks.Measure VLM capabilities--vlm_eval_kit.yaml-
Wmt TranslationotherMachine-translation verifier computing corpus-level spBLEU and ChrF per language pair plus optional xCOMET-XXL neural QE via a Ray GPU actor.Improves multilingual translation quality across spBLEU, ChrF, and COMET-family metrics.---wmt_translation.yaml-
Workplace AssistantagentWorkplace assistant multi-step tool-using environmentImprove multi-step tool use capabilityApache 2.0workplace_assistant.yamlNemotron-RL-agent-workplace_assistant
Xlam FcagentSalesforce xlam-function-calling-60k tool calling tasksImprove tool-calling capabilitiesApache 2.0xlam_fc.yaml-
XstestsafetyXSTest safety benchmark - exaggerated safety (over-refusal) evaluationEvaluate model safety calibration between helpfulness and harmlessness---xstest.yaml-

📖 Documentation & Resources

🤝 Community & Support

We'd love your contributions! Here's how to get involved:

📚 Citations

If you use NeMo Gym in your research, please cite it using the following BibTeX entry:

@misc{nemo-gym,
  title = {NeMo Gym: An Open Source Library for Scaling Reinforcement Learning Environments for LLM},
  howpublished = {\url{https://github.com/NVIDIA-NeMo/Gym}},
  author={NVIDIA},
  year = {2025},
  note = {GitHub repository},
}