Improve model card: Add metadata and sample usage

#1
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +47 -3
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 :contentReference[oaicite:0]{index=0}
14
- - **Code**: [GitHub – shawn0728/ARES](https://github.com/shawn0728/ARES) :contentReference[oaicite:1]{index=1}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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! 🚀