🏆 Live Leaderboard | 🤖 DeepScholar Live Preview
📊 Dataset | 📄 Paper | 🎮Discord
DeepScholar-Bench provides a live benchmark dataset and holistic evaluation of generative research synthesis, an emerging capability among AI systems designed for DeepResearch. We also developed DeepScholar-base, a strong open-source reference pipeline/
This repository provides:
If you run into any problems with the code in this repo, leaderboard, or dataset, please feel free to raise an issue and we will address it promptly. If you would like to add your AI system to the DeepScholar-bench leaderboard, please fill out this form.
To get started, make sure you are using Python 3.10, simply clone the repository and install dependencies as follows:
# Clone the repository
git clone [email protected]:guestrin-lab/deepscholar-bench.git
cd deepscholar-bench
# Install dependencies
conda create -n dsbench python=3.10 -y
conda activate dsbench
pip install -r requirements.txt
# Set up API keys
cp .env.example .env
# Edit .env and fill in OPENAI_API_KEY and TAVILY_API_KEY
Once you have a dataset (can use the dataset in ./dataset/ for testing or generate your own as in Benchmark Usage), run the full pipeline—report generation and evaluation—with:
./scripts/run_all.sh
Generation results are written to ./outputs/results/ and evaluation results to ./outputs/evaluation/.
You can start scraping your own datasets and running our holistic, automated evaluation suite using the commands below. For more details and a full introduction, please continue to our Dataset Scripts Description and/or our Evaluation library Description.
# Collect recent AI papers since May 1, 2025
python -m data_pipeline.main \
--categories cs.AI \
--start-date 2025-05-01
# Collect by field shorthand (cs, bio, econ, phy, stat)
python -m data_pipeline.main --field cs --field bio --start-date 2025-01-01
# Evaluate deepscholar_base outputs with gpt-4o as judge
python -m eval.main \
--modes deepscholar_base \
--evals organization nugget_coverage reference_coverage cite_p \
--input-folder tests/baselines_results/deepscholar_base_gpt_4.1 \
--output-folder results \
--dataset-path dataset/related_works_combined.csv \
--model-name gpt-4o
# Compare multiple systems
python -m eval.main \
--modes deepscholar_base openscholar \
--input-folder results/deepscholar/ results/openscholar/ \
--output-folder eval/ \
--evals all
DeepScholar-Base is our reference pipeline research synthesis pipeline that generates comprehensive literature reviews from a research query. It serves as a strong, open-source baseline and is built on LOTUS for efficient LLM-based data processing. For detailed documentation see the DeepScholar Base README.
from deepscholar_base import deepscholar_base
from deepscholar_base.configs import Configs
from lotus.models import LM
from datetime import datetime
import asyncio
configs = Configs(lm=LM(model="gpt-4o", temperature=1.0, max_tokens=10000))
async def main():
final_report, docs_df, stats = await deepscholar_base(
topic="What are the latest developments in retrieval-augmented generation?",
end_date=datetime(2025, 1, 1), # Only papers before this date
configs=configs,
)
print(final_report)
asyncio.run(main())
DeepScholar-Base can be used as an MCP (Model Context Protocol) server, letting you call it from Cursor, Claude Desktop, or any MCP-compatible client. See scripts/mcp/README.md for full setup.
# Start the MCP server (from project root)
python scripts/mcp/server.py
We welcome contributions to DeepScholarBench! Please feel free to submit a PR for code contributions. If you would like to add your AI system to the DeepScholar-bench leaderboard, please fill out this this form.
If you use DeepScholar-Bench in an academic work, we would greatly appreciate it if you can cite this work as follows:
@article{patel2025deepscholarbench,
title={DeepScholar-Bench: A Live Benchmark and Automated Evaluation for Generative Research Synthesis},
author={Liana Patel and Negar Arabzadeh and Harshit Gupta and Ankita Sundar and Ion Stoica and Matei Zaharia and Carlos Guestrin},
year={2025},
url={https://arxiv.org/abs/2508.20033},
}
214 followers · starred Nov 2025
78 followers · starred Sep 2025
79 followers · starred Jan 2026
217 followers · starred Sep 2025
🏆 Live Leaderboard | 🤖 DeepScholar Live Preview
📊 Dataset | 📄 Paper | 🎮Discord
DeepScholar-Bench provides a live benchmark dataset and holistic evaluation of generative research synthesis, an emerging capability among AI systems designed for DeepResearch. We also developed DeepScholar-base, a strong open-source reference pipeline/
This repository provides:
If you run into any problems with the code in this repo, leaderboard, or dataset, please feel free to raise an issue and we will address it promptly. If you would like to add your AI system to the DeepScholar-bench leaderboard, please fill out this form.
To get started, make sure you are using Python 3.10, simply clone the repository and install dependencies as follows:
# Clone the repository
git clone [email protected]:guestrin-lab/deepscholar-bench.git
cd deepscholar-bench
# Install dependencies
conda create -n dsbench python=3.10 -y
conda activate dsbench
pip install -r requirements.txt
# Set up API keys
cp .env.example .env
# Edit .env and fill in OPENAI_API_KEY and TAVILY_API_KEY
Once you have a dataset (can use the dataset in ./dataset/ for testing or generate your own as in Benchmark Usage), run the full pipeline—report generation and evaluation—with:
./scripts/run_all.sh
Generation results are written to ./outputs/results/ and evaluation results to ./outputs/evaluation/.
You can start scraping your own datasets and running our holistic, automated evaluation suite using the commands below. For more details and a full introduction, please continue to our Dataset Scripts Description and/or our Evaluation library Description.
# Collect recent AI papers since May 1, 2025
python -m data_pipeline.main \
--categories cs.AI \
--start-date 2025-05-01
# Collect by field shorthand (cs, bio, econ, phy, stat)
python -m data_pipeline.main --field cs --field bio --start-date 2025-01-01
# Evaluate deepscholar_base outputs with gpt-4o as judge
python -m eval.main \
--modes deepscholar_base \
--evals organization nugget_coverage reference_coverage cite_p \
--input-folder tests/baselines_results/deepscholar_base_gpt_4.1 \
--output-folder results \
--dataset-path dataset/related_works_combined.csv \
--model-name gpt-4o
# Compare multiple systems
python -m eval.main \
--modes deepscholar_base openscholar \
--input-folder results/deepscholar/ results/openscholar/ \
--output-folder eval/ \
--evals all
DeepScholar-Base is our reference pipeline research synthesis pipeline that generates comprehensive literature reviews from a research query. It serves as a strong, open-source baseline and is built on LOTUS for efficient LLM-based data processing. For detailed documentation see the DeepScholar Base README.
from deepscholar_base import deepscholar_base
from deepscholar_base.configs import Configs
from lotus.models import LM
from datetime import datetime
import asyncio
configs = Configs(lm=LM(model="gpt-4o", temperature=1.0, max_tokens=10000))
async def main():
final_report, docs_df, stats = await deepscholar_base(
topic="What are the latest developments in retrieval-augmented generation?",
end_date=datetime(2025, 1, 1), # Only papers before this date
configs=configs,
)
print(final_report)
asyncio.run(main())
DeepScholar-Base can be used as an MCP (Model Context Protocol) server, letting you call it from Cursor, Claude Desktop, or any MCP-compatible client. See scripts/mcp/README.md for full setup.
# Start the MCP server (from project root)
python scripts/mcp/server.py
We welcome contributions to DeepScholarBench! Please feel free to submit a PR for code contributions. If you would like to add your AI system to the DeepScholar-bench leaderboard, please fill out this this form.
If you use DeepScholar-Bench in an academic work, we would greatly appreciate it if you can cite this work as follows:
@article{patel2025deepscholarbench,
title={DeepScholar-Bench: A Live Benchmark and Automated Evaluation for Generative Research Synthesis},
author={Liana Patel and Negar Arabzadeh and Harshit Gupta and Ankita Sundar and Ion Stoica and Matei Zaharia and Carlos Guestrin},
year={2025},
url={https://arxiv.org/abs/2508.20033},
}
214 followers · starred Nov 2025
78 followers · starred Sep 2025
79 followers · starred Jan 2026
217 followers · starred Sep 2025