DeepResearch README

The project's README from github.com/Alibaba-NLP/DeepResearch. As one markdown file: README.md.


MODELS GITHUB Blog Paper

🤗 HuggingFace | ModelScope | 💬 WeChat(微信) | 📰 Blog | 📑 Paper

Alibaba-NLP%2FDeepResearch | Trendshift

👏 Welcome to try Tongyi DeepResearch via our Modelscope online demo or 🤗 Huggingface online demo or bailian service!

[!NOTE] This demo is for quick exploration only. Response times may vary or fail intermittently due to model latency and tool QPS limits. For a stable experience we recommend local deployment; for a production-ready service, visit bailian and follow the guided setup.

Introduction

We present Tongyi DeepResearch, an agentic large language model featuring 30.5 billion total parameters, with only 3.3 billion activated per token. Developed by Tongyi Lab, the model is specifically designed for long-horizon, deep information-seeking tasks. Tongyi DeepResearch demonstrates state-of-the-art performance across a range of agentic search benchmarks, including Humanity's Last Exam, BrowseComp, BrowseComp-ZH, WebWalkerQA,xbench-DeepSearch, FRAMES and SimpleQA.

Tongyi DeepResearch builds upon our previous work on the WebAgent project.

More details can be found in our 📰 Tech Blog.

Features

Model Download

You can directly download the model by following the links below.

Model Download Links Model Size Context Length
Tongyi-DeepResearch-30B-A3B 🤗 HuggingFace
🤖 ModelScope
30B-A3B 128K

News

[2025/09/20]🚀 Tongyi-DeepResearch-30B-A3B is now on OpenRouter! Follow the Quick-start guide.

[2025/09/17]🔥 We have released Tongyi-DeepResearch-30B-A3B.

Deep Research Benchmark Results

Quick Start

This guide provides instructions for setting up the environment and running inference scripts located in the inference folder.

1. Environment Setup

# Example with Conda
conda create -n react_infer_env python=3.10.0
conda activate react_infer_env

2. Installation

Install the required dependencies:

pip install -r requirements.txt

3. Environment Configuration and Prepare Evaluation Data

Environment Configuration

Configure your API keys and settings by copying the example environment file:

# Copy the example environment file
cp .env.example .env

Edit the .env file and provide your actual API keys and configuration values:

Note: The .env file is gitignored, so your secrets will not be committed to the repository.

Prepare Evaluation Data

The system supports two input file formats: JSON and JSONL.

Supported File Formats:

Option 1: JSONL Format (recommended)

Option 2: JSON Format

Important Note: The answer field contains the ground truth/reference answer used for evaluation. The system generates its own responses to the questions, and these reference answers are used to automatically judge the quality of the generated responses during benchmark evaluation.

File References for Document Processing:

File Organization:

project_root/
├── eval_data/
│   ├── my_questions.jsonl          # Your evaluation data
│   └── file_corpus/                # Referenced documents
│       ├── report.pdf
│       └── data.xlsx

4. Configure the Inference Script

5. Run the Inference Script

bash run_react_infer.sh

With these steps, you can fully prepare the environment, configure the dataset, and run the model. For more details, consult the inline comments in each script or open an issue.

6. You can use OpenRouter's API to call our model

Tongyi-DeepResearch-30B-A3B is now available at OpenRouter. You can run the inference without any GPUs.

You need to modify the following in the file inference/react_agent.py:

Benchmark Evaluation

We provide benchmark evaluation scripts for various datasets. Please refer to the evaluation scripts directory for more details.

FAQ

Please refer to the FAQ for more details.

Deep Research Agent Family

Tongyi DeepResearch also has an extensive deep research agent family. You can find more information in the following paper:

[1] WebWalker: Benchmarking LLMs in Web Traversal (ACL 2025)
[2] WebDancer: Towards Autonomous Information Seeking Agency (NeurIPS 2025)
[3] WebSailor: Navigating Super-human Reasoning for Web Agent
[4] WebShaper: Agentically Data Synthesizing via Information-Seeking Formalization
[5] WebWatcher: Breaking New Frontier of Vision-Language Deep Research Agent
[6] WebResearcher: Unleashing unbounded reasoning capability in Long-Horizon Agents
[7] ReSum: Unlocking Long-Horizon Search Intelligence via Context Summarization
[8] WebWeaver: Structuring Web-Scale Evidence with Dynamic Outlines for Open-Ended Deep Research
[9] WebSailor-V2: Bridging the Chasm to Proprietary Agents via Synthetic Data and Scalable Reinforcement Learning
[10] Scaling Agents via Continual Pre-training
[11] Towards General Agentic Intelligence via Environment Scaling
[12] AgentFold: Long-Horizon Web Agents with Proactive Context Management
[13] WebLeaper: Empowering Efficient, Info-Rich Seeking for Web Agents
[14] BrowseConf: Confidence-Guided Test-Time Scaling for Web Agents
[15] Repurposing Synthetic Data for Fine-grained Search Agent Supervision
[16] ParallelMuse: Agentic Parallel Thinking for Deep Information Seeking
[17] AgentFrontier: Expanding the Capability Frontier of LLM Agents with ZPD-Guided Data Synthesis
[18] Nested Browser-Use Learning for Agentic Information Seeking

🌟 Misc

Star History Chart

🚩 Talent Recruitment

🔥🔥🔥 We are hiring! Research intern positions are open (based in Hangzhou、Beijing、Shanghai)

📚 Research Area:Web Agent, Search Agent, Agent RL, MultiAgent RL, Agentic RAG

☎️ Contact:[email protected]

Contact Information

For communications, please contact Yong Jiang ([email protected]).

Citation

@article{tongyidr,
  title={Tongyi DeepResearch Technical Report},
  author={Team, Tongyi DeepResearch and Li, Baixuan and Zhang, Bo and Zhang, Dingchu and Huang, Fei and Li, Guangyu and Chen, Guoxin and Yin, Huifeng and Wu, Jialong and Zhou, Jingren and others},
  journal={arXiv preprint arXiv:2510.24701},
  year={2025}
}

DeepResearch (Alibaba-NLP/DeepResearch)

Searching Database…

Что это такое?Tongyi DeepResearch — открытая агентная LLM от Tongyi Lab (Alibaba), созданная для длительного и глубокого поиска информации в интернете. В этом репозитории лежат веса модели, а также скрипты на Python для инференса и запуска бенчмарков.
Так это приложение, которое я устанавливаю, или модель, которую мне нужно запускать самому?Это модель, а не готовое приложение: всего 30,5 млрд параметров, из которых на каждый токен активируется лишь 3,3 млрд, плюс контекстное окно на 128K. Вы скачиваете веса и запускаете их с помощью инференс-скриптов из репозитория — или не размещаете ничего сами и обращаетесь к модели через API сервиса OpenRouter.
Как мне её запустить?Создайте изолированное окружение Python 3.10 (conda или virtualenv), установите зависимости, скопируйте пример файла .env и впишите свои API-ключи, укажите инференс-скрипту путь к весам модели и файлу с вопросами, затем запустите его.
Какие сервисы и ключи нужны, чтобы она реально искала в интернете?Ключ Serper.dev для веб-поиска и Google Scholar, Jina.ai для чтения страниц, OpenAI-совместимый API для суммаризации страниц, Dashscope для разбора файлов и эндпоинт SandboxFusion для песочницы Python — всё настраивается в .env.
Можно ли просто попробовать её где-то онлайн?Да — есть демо-версии на ModelScope, HuggingFace и сервисе bailian от Alibaba. Они подходят только для быстрого знакомства: из-за задержек модели и лимитов QPS инструментов могут работать медленно или периодически сбоить.
Насколько она сильная на самом деле?По заявлениям авторов, она показывает результаты уровня SOTA в бенчмарках агентного поиска, включая Humanity's Last Exam, BrowseComp, BrowseComp-ZH, WebWalkerQA, xbench-DeepSearch, FRAMES и SimpleQA.
Что такое режим 'Heavy'?Один из двух режимов инференса, которые поддерживает модель: 'Heavy' на основе IterResearch использует test-time scaling, чтобы выжать максимальное качество, а обычный режим ReAct показывает базовые собственные способности модели.
Как обучали модель?Через полностью автоматизированный конвейер синтетических данных, на котором построены агентное продолжающееся предобучение (continual pre-training), дообучение с учителем (SFT) и обучение с подкреплением — этап RL строго on-policy, на базе доработанного фреймворка GRPO с policy-градиентами на уровне токенов.
Что ей скармливать — мне тоже нужно писать ответы?Оценка запускается на файлах JSON или JSONL с парами вопрос/ответ, но поле с ответом — это правильный ответ (ground truth), который используется только для автоматической проверки ответов модели: сам агент получает лишь вопрос. Файлы для инструмента разбора документов кладутся в evaldata/filecorpus/.
Size
302.2 MB
Stars
20.1K
Updated
CommitFeb 27
Age
1y
Commits · 90 Days