x-transformers 1.42.11__tar.gz → 1.42.14__tar.gz

{x_transformers-1.42.11/x_transformers.egg-info → x_transformers-1.42.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: x-transformers
-Version: 1.42.11
+Version: 1.42.14
 Summary: X-Transformers - Pytorch
 Home-page: https://github.com/lucidrains/x-transformers
 Author: Phil Wang
@@ -17,3 +17,4 @@ License-File: LICENSE
 Requires-Dist: torch>=2.0
 Requires-Dist: einx>=0.3.0
 Requires-Dist: einops>=0.8.0
+Requires-Dist: packaging>=21.0

{x_transformers-1.42.11 → x_transformers-1.42.14}/setup.py

@@ -3,7 +3,7 @@ from setuptools import setup, find_packages
 setup(
   name = 'x-transformers',
   packages = find_packages(exclude=['examples']),
-  version = '1.42.11',
+  version = '1.42.14',
   license='MIT',
   description = 'X-Transformers - Pytorch',
   author = 'Phil Wang',
@@ -18,7 +18,8 @@ setup(
   install_requires=[
     'torch>=2.0',
     'einx>=0.3.0',
-    'einops>=0.8.0'
+    'einops>=0.8.0',
+    'packaging>=21.0',
   ],
   setup_requires=[
     'pytest-runner',

{x_transformers-1.42.11 → x_transformers-1.42.14}/tests/test_x_transformers.py

@@ -331,7 +331,10 @@ def test_reinject_input():
 
     model(x) # (1, 1024, 20000)
 
-def test_value_residual():
+@pytest.mark.parametrize('learned_value_residual_mix', (False, True))
+def test_value_residual(
+    learned_value_residual_mix: bool
+):
 
     model = TransformerWrapper(
         num_tokens = 20000,
@@ -341,6 +344,7 @@ def test_value_residual():
             depth = 6,
             heads = 8,
             add_value_residual = True,
+            learned_value_residual_mix = learned_value_residual_mix
         )
     )
 

{x_transformers-1.42.11 → x_transformers-1.42.14}/x_transformers/x_transformers.py

@@ -1072,6 +1072,7 @@ class Attention(Module):
         logit_softclamp_value = 50.,
         neutreno_value_residual = False, # Nguyen et al. https://arxiv.org/abs/2312.00751
         neutreno_alpha = 0.4,
+        learned_value_residual_mix = False,
         onnxable = False,
         attend_sdp_kwargs: dict = dict(
             enable_flash = True,
@@ -1231,6 +1232,14 @@ class Attention(Module):
             self.mem_k = nn.Parameter(torch.randn(kv_heads, num_mem_kv, dim_head))
             self.mem_v = nn.Parameter(torch.randn(kv_heads, num_mem_kv, dim_head))
 
+        # maybe learned value residual mixer per token
+
+        self.to_value_residual_mix = nn.Sequential(
+            nn.Linear(dim, 1),
+            nn.Sigmoid(),
+            Rearrange('b n 1 -> b 1 n 1')
+         ) if learned_value_residual_mix else always(0.5)
+
         # attention on attention
 
         self.attn_on_attn = on_attn
@@ -1303,7 +1312,8 @@ class Attention(Module):
                 diff_values = repeat(diff_values, 'b h n d -> b (r h) n d', r = h // kv_h)
             else:
                 # https://arxiv.org/abs/2410.17897v1
-                v = 0.5 * (v + value_residual)
+                value_residual_mix = self.to_value_residual_mix(q_input)
+                v = v * value_residual_mix + value_residual * (1. - value_residual_mix)
 
         # take care of caching
 
@@ -1541,8 +1551,9 @@ class AttentionLayers(Module):
         use_layerscale = False,
         layerscale_init_value = 0.,
         unet_skips = False,
-        reinject_input = False,         # seen first in DEQ paper https://arxiv.org/abs/1909.01377, but later used in a number of papers trying to achieve depthwise generalization https://arxiv.org/abs/2410.03020v1
-        add_value_residual = False,     # resformer from Zhou et al - https://arxiv.org/abs/2410.17897v1
+        reinject_input = False,              # seen first in DEQ paper https://arxiv.org/abs/1909.01377, but later used in a number of papers trying to achieve depthwise generalization https://arxiv.org/abs/2410.03020v1
+        add_value_residual = False,          # resformer from Zhou et al - https://arxiv.org/abs/2410.17897v1
+        learned_value_residual_mix = False,  # seeing big improvements when the value residual mix value is learned per token - credit goes to @faresobeid for taking the first step with learned scalar mix, then @Blinkdl for taking it a step further with data dependent. here we will use per token learned
         rel_pos_kwargs: dict = dict(),
         **kwargs
     ):
@@ -1786,6 +1797,10 @@ class AttentionLayers(Module):
 
         self.add_value_residual = add_value_residual
 
+        is_first_self_attn = True
+        is_first_cross_attn = True
+        learned_value_residual_mix &= add_value_residual
+
         # iterate and construct layers
 
         for ind, (layer_type, layer_shift_tokens) in enumerate(zip(self.layer_types, shift_tokens)):
@@ -1801,9 +1816,13 @@ class AttentionLayers(Module):
             # attention, cross attention, feedforward
 
             if layer_type == 'a':
-                layer = Attention(dim, heads = heads, causal = causal, **attn_kwargs)
+                self_attn_learned_value_residual = learned_value_residual_mix and not is_first_self_attn
+                layer = Attention(dim, heads = heads, causal = causal, learned_value_residual_mix = self_attn_learned_value_residual, **attn_kwargs)
+                is_first_self_attn = False
             elif layer_type == 'c':
-                layer = Attention(dim, heads = heads, **{**attn_kwargs, **cross_attn_kwargs})
+                cross_attn_learned_value_residual = learned_value_residual_mix and not is_first_cross_attn
+                layer = Attention(dim, heads = heads, learned_value_residual_mix = learned_value_residual_mix and not is_first_cross_attn, **{**attn_kwargs, **cross_attn_kwargs})
+                is_first_cross_attn = False
             elif layer_type == 'f':
                 layer = FeedForward(dim, **ff_kwargs)
                 layer = layer if not macaron else Scale(0.5, layer)

{x_transformers-1.42.11 → x_transformers-1.42.14/x_transformers.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: x-transformers
-Version: 1.42.11
+Version: 1.42.14
 Summary: X-Transformers - Pytorch
 Home-page: https://github.com/lucidrains/x-transformers
 Author: Phil Wang
@@ -17,3 +17,4 @@ License-File: LICENSE
 Requires-Dist: torch>=2.0
 Requires-Dist: einx>=0.3.0
 Requires-Dist: einops>=0.8.0
+Requires-Dist: packaging>=21.0

{x_transformers-1.42.11 → x_transformers-1.42.14}/x_transformers.egg-info/requires.txt

@@ -1,3 +1,4 @@
 torch>=2.0
 einx>=0.3.0
 einops>=0.8.0
+packaging>=21.0