π BrowseMaster: Scalable Web Browsing via Tool-Augmented Programmatic Agent Pair
August 22, 2025 Β· View on GitHub
BrowseMaster is a next-generation LLM-based browsing agent that addresses the shortcomings of traditional search and existing agents by uniting broad, code-driven search with deep, strategic reasoning.
Its PlannerβExecutor framework delivers scalable, coherent, and efficient information seeking, achieving strong results on both BrowseComp and BrowseComp-ZH benchmarks.
π οΈ Framework

π Key Features
- π§ PlannerβExecutor Framework β Separates large-scale, code-driven search from high-level reasoning for cleaner context and deeper thinking.
- π Code-Based Search Primitives β Execute
batch_search,check_condition,generate_keywordsoperations over thousands of pages with minimal context overhead. - π― Confidence-Guided Replanning β Dynamically reset strategy when confidence is low to avoid premature convergence.
π Documentation
Prompts and Examples
- Detailed prompts for both planner and executor are available in the
prompts/directory - Sample responses from BrowseComp evaluations can be found in
logs/example.jsonl
Getting Started
Prerequisites
- For sandbox setup and code execution environment, please refer to mcp_sandbox
- Note that we use locally deployed DeepSeek series models, instead of api.
Configuration
- Configure model endpoints in
configs/model_config.yaml:- DeepSeek-R1-0528 model URL
- DeepSeek-R1 model URL
- ToolBox URL
Running BrowseMaster
- Ensure all prerequisites are met (environment, toolbox, and configuration)
- For single query inference, execute:
python agent.py
π Experiments
π Scaling Search Calls & Computation Efficiency
π Breadth of Domains Explored