hanz0212 commited on
Commit
75a0c1a
路
verified 路
1 Parent(s): b3dd6bd

Add paper badges and arXiv article citation

Browse files
README.md CHANGED
@@ -1,86 +1,96 @@
1
- ---
2
- license: mit
3
- language:
4
- - en
5
- tags:
6
- - dami
7
- - linear-attention
8
- - long-context
9
- - initialization
10
- - ruler
11
- ---
12
-
13
- # DAMI: Dual-Axis Memory Initialization for Enhanced Long-Context Retrieval in Gated Linear Attention
14
-
15
- Zhangchi Feng 路 Harry Jiang 路 Yangyifei Luo 路 Ray Zhang 路 Richong Zhang
16
-
17
- [Project page](https://speedai.com/research/dami) 路 [Code, evaluation data and scripts](https://cnb.cool/speed-ai/research/DAMI)
18
-
19
- DAMI allocates memory timescales across heads and input responses across layers to improve long-context retrieval. This repository contains the 15 paper checkpoints: five architectures (GDN, KDA, GDN2, Mamba-2, RWKV-7) with three initialization conditions (Random, PoST, DAMI). Each model has approximately 100M parameters and was trained for approximately 5B tokens with a 4096-token training context.
20
-
21
- ## Checkpoints
22
-
23
- All checkpoints are stored under `checkpoints/`, using the directory names below. Each directory contains the full model weights (`model.safetensors`), `config.json`, `generation_config.json`, `tokenizer.json`, and `tokenizer_config.json`.
24
-
25
- | Architecture | Random | PoST | DAMI |
26
- | --- | --- | --- | --- |
27
- | GDN | `main_gdn_random` | `main_gdn_PoST` | `main_gdn_DAMI` |
28
- | KDA | `main_kda_random` | `main_kda_PoST` | `main_kda_DAMI` |
29
- | GDN2 | `main_gdn2_random` | `main_gdn2_PoST` | `main_gdn2_DAMI` |
30
- | Mamba-2 | `main_mamba2_random` | `main_mamba2_PoST` | `main_mamba2_DAMI` |
31
- | RWKV-7 | `main_rwkv7_random` | `main_rwkv7_PoST` | `main_rwkv7_DAMI` |
32
-
33
- ## Download and evaluation
34
-
35
- Clone the code repository and install its dependencies as described in its README. From the code repository root, download the checkpoints:
36
-
37
- ```python
38
- from huggingface_hub import snapshot_download
39
-
40
- snapshot_download(
41
- repo_id="SpeedAI-Lab/DAMI",
42
- local_dir=".",
43
- allow_patterns=["checkpoints/**"],
44
- )
45
- ```
46
-
47
- To download only GDN + DAMI, use `allow_patterns=["checkpoints/main_gdn_DAMI/*"]`. Access to this repository requires authentication while it is private.
48
-
49
- Run all 15 checkpoints on the fixed RULER evaluation data in Linux/WSL with CUDA:
50
-
51
- ```bash
52
- python evaluate_ruler.py --preflight --all --models-root checkpoints
53
- python evaluate_ruler.py --all --models-root checkpoints \
54
- --output-dir outputs/ruler-retest --skip-done
55
- ```
56
-
57
- For a single checkpoint, replace `--all` with `--architecture gdn --initialization dami`. The evaluator includes the architecture-specific FLA and RWKV adaptations required by these checkpoints; use the provided loading path for evaluation.
58
-
59
- The code repository includes 5,500 fixed samples across 11 RULER task/length settings and 82,500 original predictions. Evaluation uses greedy decoding with up to 128 new tokens. Scores use case-insensitive answer containment; the average weights all 11 settings equally.
60
-
61
- ## RULER results
62
-
63
- Average accuracy (%), as reported in the paper:
64
-
65
- | Architecture | Random | PoST | DAMI |
66
- | --- | ---: | ---: | ---: |
67
- | GDN | 30.42 | 33.49 | 44.36 |
68
- | KDA | 26.38 | 33.67 | 43.09 |
69
- | GDN2 | 30.27 | 33.47 | 43.71 |
70
- | Mamba-2 | 9.95 | 13.73 | 24.42 |
71
- | RWKV-7 | 23.87 | 20.69 | 29.16 |
72
-
73
- ## Citation
74
-
75
- ```bibtex
76
- @misc{feng2026dami,
77
- title={DAMI: Dual-Axis Memory Initialization for Enhanced Long-Context Retrieval in Gated Linear Attention},
78
- author={Feng, Zhangchi and Jiang, Harry and Luo, Yangyifei and Zhang, Ray and Zhang, Richong},
79
- year={2026},
80
- url={https://speedai.com/research/dami}
81
- }
82
- ```
83
-
84
- ## License
85
-
86
- These checkpoints are released under the MIT License. See the LICENSE file. Benchmark attribution and data notices are provided in the code repository.
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ language:
4
+ - en
5
+ tags:
6
+ - dami
7
+ - linear-attention
8
+ - long-context
9
+ - initialization
10
+ - ruler
11
+ - arxiv:2610.41994
12
+ ---
13
+
14
+ # DAMI: Dual-Axis Memory Initialization for Enhanced Long-Context Retrieval in Gated Linear Attention
15
+
16
+ <div align="center">
17
+
18
+ [![License: MIT](badges/license.svg)](https://huggingface.co/SpeedAI-Lab/DAMI/blob/main/LICENSE)
19
+ [![arXiv: 2610.41994](badges/arxiv.svg)](https://arxiv.org/abs/2610.41994)
20
+ ![GitHub: link pending](badges/github.svg)
21
+ [![Hugging Face: Checkpoints](badges/huggingface.svg)](https://huggingface.co/SpeedAI-Lab/DAMI)
22
+
23
+ </div>
24
+
25
+ Zhangchi Feng 路 Harry Jiang 路 Yangyifei Luo 路 Ray Zhang 路 Richong Zhang
26
+
27
+ [Project page](https://speedai.com/research/dami) 路 [Code, evaluation data and scripts](https://cnb.cool/speed-ai/research/DAMI)
28
+
29
+ DAMI allocates memory timescales across heads and input responses across layers to improve long-context retrieval. This repository contains the 15 paper checkpoints: five architectures (GDN, KDA, GDN2, Mamba-2, RWKV-7) with three initialization conditions (Random, PoST, DAMI). Each model has approximately 100M parameters and was trained for approximately 5B tokens with a 4096-token training context.
30
+
31
+ ## Checkpoints
32
+
33
+ All checkpoints are stored under `checkpoints/`, using the directory names below. Each directory contains the full model weights (`model.safetensors`), `config.json`, `generation_config.json`, `tokenizer.json`, and `tokenizer_config.json`.
34
+
35
+ | Architecture | Random | PoST | DAMI |
36
+ | --- | --- | --- | --- |
37
+ | GDN | `main_gdn_random` | `main_gdn_PoST` | `main_gdn_DAMI` |
38
+ | KDA | `main_kda_random` | `main_kda_PoST` | `main_kda_DAMI` |
39
+ | GDN2 | `main_gdn2_random` | `main_gdn2_PoST` | `main_gdn2_DAMI` |
40
+ | Mamba-2 | `main_mamba2_random` | `main_mamba2_PoST` | `main_mamba2_DAMI` |
41
+ | RWKV-7 | `main_rwkv7_random` | `main_rwkv7_PoST` | `main_rwkv7_DAMI` |
42
+
43
+ ## Download and evaluation
44
+
45
+ Clone the code repository and install its dependencies as described in its README. From the code repository root, download the checkpoints:
46
+
47
+ ```python
48
+ from huggingface_hub import snapshot_download
49
+
50
+ snapshot_download(
51
+ repo_id="SpeedAI-Lab/DAMI",
52
+ local_dir=".",
53
+ allow_patterns=["checkpoints/**"],
54
+ )
55
+ ```
56
+
57
+ To download only GDN + DAMI, use `allow_patterns=["checkpoints/main_gdn_DAMI/*"]`. Access to this repository requires authentication while it is private.
58
+
59
+ Run all 15 checkpoints on the fixed RULER evaluation data in Linux/WSL with CUDA:
60
+
61
+ ```bash
62
+ python evaluate_ruler.py --preflight --all --models-root checkpoints
63
+ python evaluate_ruler.py --all --models-root checkpoints \
64
+ --output-dir outputs/ruler-retest --skip-done
65
+ ```
66
+
67
+ For a single checkpoint, replace `--all` with `--architecture gdn --initialization dami`. The evaluator includes the architecture-specific FLA and RWKV adaptations required by these checkpoints; use the provided loading path for evaluation.
68
+
69
+ The code repository includes 5,500 fixed samples across 11 RULER task/length settings and 82,500 original predictions. Evaluation uses greedy decoding with up to 128 new tokens. Scores use case-insensitive answer containment; the average weights all 11 settings equally.
70
+
71
+ ## RULER results
72
+
73
+ Average accuracy (%), as reported in the paper:
74
+
75
+ | Architecture | Random | PoST | DAMI |
76
+ | --- | ---: | ---: | ---: |
77
+ | GDN | 30.42 | 33.49 | 44.36 |
78
+ | KDA | 26.38 | 33.67 | 43.09 |
79
+ | GDN2 | 30.27 | 33.47 | 43.71 |
80
+ | Mamba-2 | 9.95 | 13.73 | 24.42 |
81
+ | RWKV-7 | 23.87 | 20.69 | 29.16 |
82
+
83
+ ## Citation
84
+
85
+ ```bibtex
86
+ @article{feng2026dami,
87
+ title={DAMI: Dual-Axis Memory Initialization for Enhanced Long-Context Retrieval in Gated Linear Attention},
88
+ author={Feng, Zhangchi and Jiang, Harry and Luo, Yangyifei and Zhang, Ray and Zhang, Richong},
89
+ journal={arXiv preprint arXiv:2610.41994},
90
+ year={2026}
91
+ }
92
+ ```
93
+
94
+ ## License
95
+
96
+ These checkpoints are released under the MIT License. See the LICENSE file. Benchmark attribution and data notices are provided in the code repository.
badges/arxiv.svg ADDED
badges/github.svg ADDED
badges/huggingface.svg ADDED
badges/license.svg ADDED