Image-Text-to-Text
Transformers
Safetensors
qwen3_5
agent
deep-research
reasoning
tool-use
long-context
self-improvement
conversational
Instructions to use cfli/AREX-2 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use cfli/AREX-2 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="cfli/AREX-2") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("cfli/AREX-2") model = AutoModelForMultimodalLM.from_pretrained("cfli/AREX-2", device_map="auto") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] inputs = processor.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=256) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use cfli/AREX-2 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "cfli/AREX-2" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cfli/AREX-2", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/cfli/AREX-2
- SGLang
How to use cfli/AREX-2 with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "cfli/AREX-2" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cfli/AREX-2", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "cfli/AREX-2" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cfli/AREX-2", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Docker Model Runner
How to use cfli/AREX-2 with Docker Model Runner:
docker model run hf.co/cfli/AREX-2
Add files using upload-large-folder tool
Browse files
README.md
CHANGED
|
@@ -14,7 +14,14 @@ tags:
|
|
| 14 |
- safetensors
|
| 15 |
---
|
| 16 |
|
| 17 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 18 |
|
| 19 |
AREX-2 is a 27B-parameter long-horizon agent model from the Beijing Academy of
|
| 20 |
Artificial Intelligence (BAAI). It learns to improve a solution over multiple
|
|
@@ -25,53 +32,95 @@ verifiable feedback, together with the existing AREX deep-research data. The
|
|
| 25 |
learned self-improvement behavior transfers to deep research without adding new
|
| 26 |
search trajectories.
|
| 27 |
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
|
| 32 |
-
|
| 33 |
-
|
| 34 |
-
- **Backbone:** Qwen3.8-27B, dense multimodal model
|
| 35 |
-
- **Context:** 262,144 tokens
|
| 36 |
-
- **Weights:** BF16 Safetensors, 11 shards
|
| 37 |
-
- **Inputs:** text, images, and videos
|
| 38 |
- **Tool calls:** XML (`<tool_call>...</tool_call>`)
|
| 39 |
|
| 40 |
-
##
|
| 41 |
-
|
| 42 |
-
AREX-2 treats self-improvement as test-time scaling: more rounds should produce
|
| 43 |
-
more useful progress. Its training pipeline is:
|
| 44 |
-
|
| 45 |
-
1. **Build environments.** Teacher models turn machine-learning repositories
|
| 46 |
-
and online-judge problems into sandboxes with tasks and executable scorers.
|
| 47 |
-
Environments must have a valid reference solution and room to improve over a
|
| 48 |
-
simple baseline.
|
| 49 |
-
2. **Generate trajectories.** A teacher agent works for many rounds, reading,
|
| 50 |
-
searching, editing, running experiments, submitting solutions, and using
|
| 51 |
-
feedback to choose the next step. Failures and recoveries remain in context.
|
| 52 |
-
3. **Select and supervise.** Keep trajectories with a strong final score and a
|
| 53 |
-
valid process. Apply training loss to decisions that diagnose failures,
|
| 54 |
-
change strategy, or improve the solution; ignore polling, duplicates, and
|
| 55 |
-
environment messages.
|
| 56 |
-
4. **Fine-tune.** Mix the selected trajectories with the unchanged AREX
|
| 57 |
-
deep-research data and fine-tune Qwen3.8-27B.
|
| 58 |
|
| 59 |
-
|
| 60 |
-
|
| 61 |
-
|
| 62 |
-
|
| 63 |
-
|
| 64 |
-
|
| 65 |
-
|
| 66 |
-
|
| 67 |
-
| GAIA | Accuracy | **92.2** |
|
| 68 |
-
| DeepSearchQA | F1 | **93.8** |
|
| 69 |
|
| 70 |
-
|
| 71 |
-
task and 12 hours per MLE-Lite task. Non-coding evaluations allow up to 300
|
| 72 |
-
inner turns and 1,500 total turns.
|
| 73 |
|
| 74 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 75 |
|
| 76 |
Use a recent Transformers release with Qwen3.8 support.
|
| 77 |
|
|
@@ -94,11 +143,8 @@ messages = [{
|
|
| 94 |
"content": "Propose a solution and explain how you would improve it over several rounds.",
|
| 95 |
}]
|
| 96 |
inputs = processor.apply_chat_template(
|
| 97 |
-
messages,
|
| 98 |
-
|
| 99 |
-
tokenize=True,
|
| 100 |
-
return_dict=True,
|
| 101 |
-
return_tensors="pt",
|
| 102 |
).to(model.device)
|
| 103 |
|
| 104 |
with torch.inference_mode():
|
|
@@ -109,11 +155,11 @@ print(processor.decode(
|
|
| 109 |
```
|
| 110 |
|
| 111 |
For images or videos, use the standard Qwen multimodal content format. For
|
| 112 |
-
|
| 113 |
-
|
| 114 |
-
|
| 115 |
|
| 116 |
-
## Intended use
|
| 117 |
|
| 118 |
AREX-2 is intended for research on long-horizon agents, iterative problem
|
| 119 |
solving, machine-learning engineering, algorithmic coding, and tool-augmented
|
|
|
|
| 14 |
- safetensors
|
| 15 |
---
|
| 16 |
|
| 17 |
+
<div align="center">
|
| 18 |
+
<strong>AREX-2: Advancing Self-Improving Agents through Long-Horizon Reflective Tasks</strong><br>
|
| 19 |
+
<a href="https://arxiv.org/abs/2607.21461"><img src="https://img.shields.io/badge/-Paper-B31B1B?style=for-the-badge&logo=arxiv&logoColor=white" alt="Paper"></a>
|
| 20 |
+
<a href="https://github.com/VectorSpaceLab/AREX-2"><img src="https://img.shields.io/badge/-Homepage-24292F?style=for-the-badge&logo=github&logoColor=white" alt="Homepage"></a>
|
| 21 |
+
<a href="https://huggingface.co/collections/BAAI/arex-2"><img src="https://img.shields.io/badge/-Collection-FFD21E?style=for-the-badge&logo=huggingface&logoColor=black" alt="Model collection"></a>
|
| 22 |
+
</div>
|
| 23 |
+
|
| 24 |
+
## Introduction
|
| 25 |
|
| 26 |
AREX-2 is a 27B-parameter long-horizon agent model from the Beijing Academy of
|
| 27 |
Artificial Intelligence (BAAI). It learns to improve a solution over multiple
|
|
|
|
| 32 |
learned self-improvement behavior transfers to deep research without adding new
|
| 33 |
search trajectories.
|
| 34 |
|
| 35 |
+
- **Architecture:** Dense Qwen3.8-compatible multimodal model
|
| 36 |
+
- **Parameters:** 27B
|
| 37 |
+
- **Context length:** 262,144 tokens
|
| 38 |
+
- **Tensor type:** BF16
|
| 39 |
+
- **Inputs:** Text, images, and videos
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 40 |
- **Tool calls:** XML (`<tool_call>...</tool_call>`)
|
| 41 |
|
| 42 |
+
## Key features
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 43 |
|
| 44 |
+
- **Long-horizon self-improvement:** turns additional test-time rounds into
|
| 45 |
+
continued solution refinement.
|
| 46 |
+
- **Feedback-driven reflection:** uses scores, logs, errors, and timings to
|
| 47 |
+
decide what to try next.
|
| 48 |
+
- **Cross-domain transfer:** learns from verifiable coding and ML tasks, then
|
| 49 |
+
applies the behavior to deep research.
|
| 50 |
+
- **Long-horizon tool use:** supports multi-round reasoning, tool calls, and
|
| 51 |
+
multimodal inputs. External tools are provided by the host application.
|
|
|
|
|
|
|
| 52 |
|
| 53 |
+
## Evaluation
|
|
|
|
|
|
|
| 54 |
|
| 55 |
+
AREX-2 is evaluated on algorithmic programming, machine-learning engineering,
|
| 56 |
+
deep research, and general agentic reasoning. Results follow the protocols
|
| 57 |
+
reported in the AREX-2 paper.
|
| 58 |
+
|
| 59 |
+
### Coding and machine-learning engineering
|
| 60 |
+
|
| 61 |
+
| Model | Params | Frontier-CS | MLE-Lite |
|
| 62 |
+
| --- | ---: | ---: | ---: |
|
| 63 |
+
| GPT-5.6 Sol | - | 76.4 | 72.7 |
|
| 64 |
+
| Claude Opus 4.8 | - | 74.5 | 63.6 |
|
| 65 |
+
| GPT-5.5 | - | 72.1 | 68.2 |
|
| 66 |
+
| Gemini-3.1-Pro | - | 68.9 | - |
|
| 67 |
+
| Qwen3.7-Max | - | 61.9 | - |
|
| 68 |
+
| Kimi-K3 | 2.8T | - | 72.7 |
|
| 69 |
+
| Naive-N0.5-Flash | 309B | - | 73.7 |
|
| 70 |
+
| DeepSeek-V4-Pro | 1.6T | 44.7* | 54.5 |
|
| 71 |
+
| DeepSeek-V4-Flash | 284B | 39.1* | 51.5 |
|
| 72 |
+
| Kimi-K2.7-Code | 1T | 54.7* | - |
|
| 73 |
+
| GLM-5.3-Flash | 320B | 50.4* | - |
|
| 74 |
+
| Kimi-K2.6 | 1T | 46.9 | 66.7 |
|
| 75 |
+
| Frontis-MA1-35B | 35B | - | 71.2 |
|
| 76 |
+
| BigBang-V1 | 35B | - | 59.1 |
|
| 77 |
+
| Qwen3.6-35B-A3B | 35B | 23.4* | 39.4 |
|
| 78 |
+
| **AREX-2** | **27B** | **70.7** | **81.8** |
|
| 79 |
+
|
| 80 |
+
Frontier-CS is the 188-task Agent Track. `*` marks results reproduced by the
|
| 81 |
+
AREX team. MLE-Lite reports Any Medal averaged over three seeds.
|
| 82 |
+
|
| 83 |
+
### General agentic reasoning and deep research
|
| 84 |
+
|
| 85 |
+
| Model | Params | BrowseComp | HLE | GAIA | DeepSearchQA |
|
| 86 |
+
| --- | ---: | ---: | ---: | ---: | ---: |
|
| 87 |
+
| GPT-5.6 Sol | - | 90.4 | 58.0* | - | - |
|
| 88 |
+
| GPT-5.6 Terra | - | 87.5 | - | - | - |
|
| 89 |
+
| GPT-5.6 Luna | - | 83.3 | - | - | - |
|
| 90 |
+
| Kimi-K3 | 2.8T | 91.2 | 56.0* | - | 95.0 |
|
| 91 |
+
| Claude Fable 5 | - | 88.0 | 64.5* | - | 94.2 |
|
| 92 |
+
| Claude Opus 4.8 | - | 84.3 | 57.9* | - | 93.1 |
|
| 93 |
+
| GPT-5.5 | - | 84.4 | 52.2* | 87.4 | - |
|
| 94 |
+
| Gemini-3.1-Pro | - | 85.9 | 51.4* | 80.6 | 93.3 |
|
| 95 |
+
| GLM-5 | 744B | 75.9 | 50.4 | 70.0 | - |
|
| 96 |
+
| Kimi-K2.6 | 1T | 83.2 | 54.0* | 80.6 | 92.5 |
|
| 97 |
+
| GLM-5.3-Flash | 320B | - | 55.3* | 78.8 | - |
|
| 98 |
+
| DeepSeek-V4-Flash | 284B | 73.2 | 45.1 | 57.5 | 90.6 |
|
| 99 |
+
| DeepSeek-V4-Pro | 1.6T | 83.4 | 48.2 | 71.1 | 88.7 |
|
| 100 |
+
| MiroThinker-1.7 | 235B | 74.0 | 42.9 | 82.7 | 72.1 |
|
| 101 |
+
| XYZ-Aquila-pro | 397B | 84.8 | 53.3 | - | 92.5 |
|
| 102 |
+
| Iris-pro | 397B | 88.6 | 56.4 | - | 92.9 |
|
| 103 |
+
| **AREX-Base** | **122B** | **82.5** | **52.4** | **85.4** | **89.9** |
|
| 104 |
+
| Tongyi-DeepResearch-30B | 30B | 43.4 | 32.9 | 70.9 | - |
|
| 105 |
+
| Qwen3.5-35B | 35B | 61.0 | 47.4 | 80.0 | 68.5 |
|
| 106 |
+
| XYZ-Aquila-mini | 35B | 78.8 | 51.1 | 97.1 | 89.5 |
|
| 107 |
+
| BigBang-V1 | 35B | 76.5 | 50.3 | - | - |
|
| 108 |
+
| Quest-35B | 35B | 64.6 | 37.2 | 80.8 | - |
|
| 109 |
+
| Apodex-1.0-mini | 35B | 71.5 | 46.8 | - | 82.2 |
|
| 110 |
+
| Agents-A1 | 35B | 75.5 | 47.6 | 96.0 | - |
|
| 111 |
+
| MiroThinker-1.7-mini | 30B | 67.9 | 36.4 | 80.3 | 67.9 |
|
| 112 |
+
| Iris-mini | 35B | 82.2 | 52.3 | - | 86.9 |
|
| 113 |
+
| **AREX-Turbo** | **4B** | **70.7** | **40.6** | **81.6** | **78.5** |
|
| 114 |
+
| **AREX-2** | **27B** | **84.0** | **52.6** | **92.2** | **93.8** |
|
| 115 |
+
|
| 116 |
+
Metrics are accuracy except DeepSearchQA, which uses F1. HLE values marked `*`
|
| 117 |
+
are from the full HLE set; unmarked values use the text-only subset.
|
| 118 |
+
|
| 119 |
+
For non-coding benchmarks, evaluation allows up to 300 inner turns and 1,500
|
| 120 |
+
total turns. Frontier-CS uses a five-hour budget per task, and MLE-Lite uses the
|
| 121 |
+
OpenMLE protocol with a 12-hour budget per task.
|
| 122 |
+
|
| 123 |
+
## Inference
|
| 124 |
|
| 125 |
Use a recent Transformers release with Qwen3.8 support.
|
| 126 |
|
|
|
|
| 143 |
"content": "Propose a solution and explain how you would improve it over several rounds.",
|
| 144 |
}]
|
| 145 |
inputs = processor.apply_chat_template(
|
| 146 |
+
messages, add_generation_prompt=True, tokenize=True,
|
| 147 |
+
return_dict=True, return_tensors="pt",
|
|
|
|
|
|
|
|
|
|
| 148 |
).to(model.device)
|
| 149 |
|
| 150 |
with torch.inference_mode():
|
|
|
|
| 155 |
```
|
| 156 |
|
| 157 |
For images or videos, use the standard Qwen multimodal content format. For
|
| 158 |
+
tool use, pass tool schemas to `apply_chat_template`; the host must execute the
|
| 159 |
+
XML call and return the result as a `tool` message. AREX-2 does not include
|
| 160 |
+
external search, browsing, or code-execution tools.
|
| 161 |
|
| 162 |
+
## Intended use
|
| 163 |
|
| 164 |
AREX-2 is intended for research on long-horizon agents, iterative problem
|
| 165 |
solving, machine-learning engineering, algorithmic coding, and tool-augmented
|