Improve model card: Update pipeline tag, add comprehensive details and demos

README.md

@@ -1,16 +1,111 @@
 ---
-library_name: transformers
-pipeline_tag: text-generation
-license: mit
 base_model:
 - Qwen/QwQ-32B
+library_name: transformers
+license: mit
+pipeline_tag: image-text-to-text
+tags:
+- web-agent
+- gui-agent
+- multimodal
+- reinforcement-learning
+- react
 ---
 
-This model was presented in the paper [WebDancer: Towards Autonomous Information Seeking Agency](https://huggingface.co/papers/2505.22648).
+# WebDancer: Towards Autonomous Information Seeking Agency
+
+This repository contains the **WebDancer** model, presented in the paper [WebDancer: Towards Autonomous Information Seeking Agency](https://huggingface.co/papers/2505.22648).
+
+**Code & Project Page**: https://github.com/Alibaba-NLP/WebAgent
+
+## Abstract
+Addressing intricate real-world problems necessitates in-depth information seeking and multi-step reasoning. Recent progress in agentic systems, exemplified by Deep Research, underscores the potential for autonomous multi-step research. In this work, we present a cohesive paradigm for building end-to-end agentic information seeking agents from a data-centric and training-stage perspective. Our approach consists of four key stages: (1) browsing data construction, (2) trajectories sampling, (3) supervised fine-tuning for effective cold start, and (4) reinforcement learning for enhanced generalisation. We instantiate this framework in a web agent based on the ReAct, WebDancer. Empirical evaluations on the challenging information seeking benchmarks, GAIA and WebWalkerQA, demonstrate the strong performance of WebDancer, achieving considerable results and highlighting the efficacy of our training paradigm. Further analysis of agent training provides valuable insights and actionable, systematic pathways for developing more capable agentic models. The codes and demo will be released in this https URL .
+
+## Features for WebDancer
+
+*   Native agentic search reasoning model using ReAct framework towards autonomous information seeking agency and _Deep Research_-like model.
+*   We introduce a four-stage training paradigm comprising **browsing data construction, trajectory sampling, supervised fine-tuning for effective cold start, and reinforcement learning for improved generalization**, enabling the agent to autonomously acquire autonomous search and reasoning skills.
+*   Our data-centric approach integrates trajectory-level supervision fine-tuning and reinforcement learning (DAPO) to develop a scalable pipeline for **training agentic systems** via SFT or RL.
+*   WebDancer achieves a Pass@3 score of 64.1% on GAIA and 62.0% on WebWalkerQA.
+
+## Quick Start
+
+You need to enter the [`WebDancer`](https://github.com/Alibaba-NLP/WebAgent/tree/main/WebDancer) folder for the following commands.
+
+### Step 0: Set Up the Environment
+
+```bash
+conda create -n webdancer python=3.12
+pip install -r requirements.txt
+```
+
+### Step 1: Deploy the Model
+
+Download the WebDancer model from [🤗 HuggingFace](https://huggingface.co/Alibaba-NLP/WebDancer-32B) and deploy it using the provided scripts with [sglang](https://github.com/sgl-project/sglang).
+
+```bash
+cd scripts
+bash depoly_model.sh WebDancer_PATH
+```
+
+> **Note:** Replace `WebDancer_PATH` with the actual path to the downloaded model.
+
+### Step 2: Run the Demo
+
+Edit the following keys in [`WebDancer/scripts/run_demo.sh`](https://github.com/Alibaba-NLP/WebAgent/blob/main/WebDancer/scripts/run_demo.sh):
+
+- `GOOGLE_SEARCH_KEY`
+- `JINA_API_KEY`
+- `DASHSCOPE_API_KEY`
+
+Then, launch the demo with Gradio to interact with the WebDancer model:
+
+```bash
+cd scripts
+bash run_demo.sh
+```
+
+## Demos
+
+We provide demos for WebWalkerQA, GAIA and Daily Use.
+Our model can execute the long-horizon tasks with **multiple steps** and **complex reasoning**, such as web traversal, information seeking and question answering.
+
+<div align="center">
+    <h3>WebWalkerQA</h3>
+    <video src="https://github.com/user-attachments/assets/0bbaf55b-897e-4c57-967d-a6e8bbd2167e" />
+</div>
+
+<div align="center">
+    <h3>GAIA</h3>
+    <video src="https://github.com/user-attachments/assets/935c668e-6169-4712-9c04-ac80f0531872" />
+</div>
+
+<div align="center">
+    <h3>Daily Use</h3>
+    <video src="https://github.com/user-attachments/assets/d1d5b533-4009-478b-bd87-96b86389327d" />
+</div>
+
+## Citation
 
-You can download the model then run the inference scipts in https://github.com/Alibaba-NLP/WebAgent.
+If this work is helpful, please kindly cite as:
 
-- Native agentic search reasoning model using ReAct framework towards autonomous information seeking agency and Deep Research-like model.
-- We introduce a four-stage training paradigm comprising browsing data construction, trajectory sampling, supervised fine-tuning for effective cold start, and reinforcement learning for improved generalization, enabling the agent to autonomously acquire autonomous search and reasoning skills.
-- Our data-centric approach integrates trajectory-level supervision fine-tuning and reinforcement learning (DAPO) to develop a scalable pipeline for training agentic systems via SFT or RL.
-- WebDancer achieves a Pass@3 score of 61.1% on GAIA and 54.6% on WebWalkerQA.
+```bibquery
+@misc{wu2025webdancer,
+      title={WebDancer: Towards Autonomous Information Seeking Agency},
+      author={Jialong Wu and Baixuan Li and Runnan Fang and Wenbiao Yin and Liwen Zhang and Zhengwei Tao and Dingchu Zhang and Zekun Xi and Yong Jiang and Pengjun Xie and Fei Huang and Jingren Zhou},
+      year={2025},
+      eprint={2505.22648},
+      archivePrefix={arXiv},
+      primaryClass={cs.CL},
+      url={https://arxiv.org/abs/2505.22648},
+}
+@misc{wu2025webwalker,
+      title={WebWalker: Benchmarking LLMs in Web Traversal},
+      author={Jialong Wu and Wenbiao Yin and Yong Jiang and Zhenglin Wang and Zekun Xi and Runnan Fang and Deyu Zhou and Pengjun Xie and Fei Huang},
+      year={2025},
+      eprint={2501.07572},
+      archivePrefix={arXiv},
+      primaryClass={cs.CL},
+      url={https://arxiv.org/abs/2501.07572},
+}
+```