Improve model card: Add metadata and sample usage
#1
by
nielsr
HF Staff
- opened
README.md
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
🌟 **ARES** — Adaptive Multimodal Reasoning Framework
|
| 2 |
Two-stage adaptive reasoning: cold-start + entropy-shaped RL.
|
| 3 |
|
|
@@ -10,8 +16,46 @@ SOTA efficiency–accuracy tradeoffs on diverse multimodal and textual benchmark
|
|
| 10 |
2. **Entropy-Shaped RL (AEPO)** — trigger exploration via high-window entropy, hierarchical rewards
|
| 11 |
|
| 12 |
📂 Resources
|
| 13 |
-
- **Paper**: ARES: Multimodal Adaptive Reasoning via Difficulty-Aware Token-Level Entropy Shaping
|
| 14 |
-
- **Code**: [GitHub – shawn0728/ARES](https://github.com/shawn0728/ARES)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 15 |
|
| 16 |
📌 Citation
|
| 17 |
```
|
|
@@ -28,4 +72,4 @@ SOTA efficiency–accuracy tradeoffs on diverse multimodal and textual benchmark
|
|
| 28 |
|
| 29 |
---
|
| 30 |
|
| 31 |
-
Give **ARES** a shot and tell us what reasoning challenges it helps you solve! 🚀
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
library_name: transformers
|
| 4 |
+
pipeline_tag: image-text-to-text
|
| 5 |
+
---
|
| 6 |
+
|
| 7 |
🌟 **ARES** — Adaptive Multimodal Reasoning Framework
|
| 8 |
Two-stage adaptive reasoning: cold-start + entropy-shaped RL.
|
| 9 |
|
|
|
|
| 16 |
2. **Entropy-Shaped RL (AEPO)** — trigger exploration via high-window entropy, hierarchical rewards
|
| 17 |
|
| 18 |
📂 Resources
|
| 19 |
+
- **Paper**: [ARES: Multimodal Adaptive Reasoning via Difficulty-Aware Token-Level Entropy Shaping](https://huggingface.co/papers/2510.08457)
|
| 20 |
+
- **Code**: [GitHub – shawn0728/ARES](https://github.com/shawn0728/ARES)
|
| 21 |
+
|
| 22 |
+
---
|
| 23 |
+
|
| 24 |
+
## Sample Usage
|
| 25 |
+
|
| 26 |
+
Run the command below.
|
| 27 |
+
```python
|
| 28 |
+
MODEL_PATH="ARES"
|
| 29 |
+
MAX_TOKENS=16384
|
| 30 |
+
DO_SAMPLE=True
|
| 31 |
+
TEMPERATURE=1.0
|
| 32 |
+
TOP_P=0.95
|
| 33 |
+
TOP_K=50
|
| 34 |
+
NUM_RETURN_SEQUENCES=1
|
| 35 |
+
|
| 36 |
+
|
| 37 |
+
prompt = "You FIRST think about the reasoning process as an internal monologue and then provide the final answer. The reasoning process MUST BE enclosed within <think> </think> tags. The final answer MUST BE put in \\boxed{}."
|
| 38 |
+
question="xxx"
|
| 39 |
+
|
| 40 |
+
|
| 41 |
+
python infer.py \
|
| 42 |
+
--model_path ${MODEL_PATH} \
|
| 43 |
+
--image_path ${IMAGE_PATH} \
|
| 44 |
+
--question ${question} \
|
| 45 |
+
--prompt ${prompt} \
|
| 46 |
+
--max_tokens ${MAX_TOKENS} \
|
| 47 |
+
--do_sample ${DO_SAMPLE} \
|
| 48 |
+
--temperature ${TEMPERATURE} \
|
| 49 |
+
--top_p ${TOP_P} \
|
| 50 |
+
--top_k ${TOP_K} \
|
| 51 |
+
--num_return_sequences ${NUM_RETURN_SEQUENCES}
|
| 52 |
+
```
|
| 53 |
+
You can also modify the arguments in `inference/inference.sh`
|
| 54 |
+
```shell
|
| 55 |
+
bash inference/inference.sh
|
| 56 |
+
```
|
| 57 |
+
|
| 58 |
+
---
|
| 59 |
|
| 60 |
📌 Citation
|
| 61 |
```
|
|
|
|
| 72 |
|
| 73 |
---
|
| 74 |
|
| 75 |
+
Give **ARES** a shot and tell us what reasoning challenges it helps you solve! 🚀
|