README.md

May 21, 2025 ยท View on GitHub

WEB-SHEPHERD Logo

Web-Shepherd: Advancing Process Reward Models for Web Agents

PDF Model Dataset Hugging Face Demo

Web-Shepherd is the first process reward model (PRM) designed specifically for web agents. It evaluates trajectories at the step level to provide interpretable and cost-efficient feedback for both learning and inference-time decision making in web navigation tasks.


๐Ÿš€ Overview

Recent multimodal language models (MLLMs) have made progress in web automation but struggle with long-horizon planning and cost efficiency. To tackle this, Web-Shepherd introduces:

  • WebPRM Collection: A dataset with 40K+ step-level preference annotations and structured checklists.
  • WebRewardBench: A benchmark to test PRM effectiveness across diverse web tasks.
  • Web-Shepherd: A PRM trained to provide step-wise feedback and reward using structured subgoal checklists.

๐Ÿง  Key Features

  • โœ… Step-level trajectory evaluation for web agents
  • ๐Ÿงพ Checklist-guided reward modeling for interpretability and progress awareness
  • ๐Ÿ’ฐ 100ร— cost reduction compared to prompting GPT-4o
  • ๐Ÿ“ˆ Outperforms GPT-4o-mini by 10.9 points on WebArena-lite
  • ๐Ÿ”„ Various use cases, including RL, Trajectory Search, and Reflexion

WebPRM Collection Overview


๐Ÿ’Ž Assets

ResourceDescriptionSizeLink
WebPRM CollectionStep-level preference annotations with structured checklists40K+ annotations๐Ÿค— huggingface
WebRewardBenchComprehensive benchmark for evaluating PRM effectiveness1000+ test cases๐Ÿค— huggingface
Web-Shepherd (3B, text-only)Trained process reward model for web navigation3B parameters๐Ÿค— huggingface
Web-Shepherd (3B, ๐Ÿ–ผ๏ธ multimodal)Trained process reward model for web navigation3B parametersComing Soon!
Web-Shepherd (8B, text-only)Large version of Web-Shepherd8B parameters๐Ÿค— huggingface

WebPRM Collection

WebPRM Collection Overview

The WebPRM Collection contains over 40K step-level preference annotations across diverse web tasks. Each annotation includes:

  • Structured Checklists: Task-specific criteria for evaluating step quality
  • Step-level Preferences: Human annotations comparing trajectory steps
  • Rich Metadata: Task context, action types, and rationales

The dataset enables training process reward models that can provide interpretable feedback for web navigation.

Web-Shepherd

Web-Shepherd Architecture

Web-Shepherd is a process reward model trained on the WebPRM Collection to provide step-level feedback for web navigation tasks. Key components include:

  • Checklist Generation: Processes text and visual inputs from web pages
  • Reward Prediction with Checklist: Incorporates structured evaluation criteria

The model achieves strong performance while being significantly more cost-efficient than alternatives like GPT-4o.

๐Ÿ“‚ Project Structure

.
โ”œโ”€โ”€ webshepherd/                 # Source code for the model
โ”‚   โ”œโ”€โ”€ models/                  # Model architecture & training
โ”‚   โ”œโ”€โ”€ data/                    # Dataset loading and processing
โ”‚   โ””โ”€โ”€ inference/               # Inference utilities (e.g., Best-of-n, feedback)
โ”œโ”€โ”€ scripts/                     # Training & evaluation scripts
โ”œโ”€โ”€ configs/                     # Model configs and experiment settings
โ”œโ”€โ”€ data/                        # Downloaded or generated datasets
โ”‚   โ”œโ”€โ”€ webprm_collection/       # Annotated instructions, checklists, and actions
โ”‚   โ””โ”€โ”€ webrewardbench/          # Meta-evaluation benchmark
โ”œโ”€โ”€ demo/                        # Hugging Face Space setup (optional)
โ”œโ”€โ”€ results/                     # Logs and evaluation outputs
โ””โ”€โ”€ README.md