x-transformers 2.11.7__tar.gz → 2.11.9__tar.gz

{x_transformers-2.11.7 → x_transformers-2.11.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x-transformers
-Version: 2.11.7
+Version: 2.11.9
 Summary: X-Transformers
 Project-URL: Homepage, https://pypi.org/project/x-transformers/
 Project-URL: Repository, https://github.com/lucidrains/x-transformers

{x_transformers-2.11.7 → x_transformers-2.11.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "x-transformers"
-version = "2.11.7"
+version = "2.11.9"
 description = "X-Transformers"
 authors = [
     { name = "Phil Wang", email = "lucidrains@gmail.com" }

{x_transformers-2.11.7 → x_transformers-2.11.9}/tests/test_x_transformers.py

@@ -1410,7 +1410,9 @@ def test_attn_negative_weights(
     logits = model(x)
 
 @param('per_token_latents', (False, True))
+@param('dec_head_depth', (0, 4))
 def test_free(
+    dec_head_depth,
     per_token_latents
 ):
     from x_transformers.free_transformer import FreeTransformer
@@ -1420,9 +1422,9 @@ def test_free(
         max_seq_len = 1024,
         dim = 512,
         heads = 8,
-        dec_head_depth = 4,
+        dec_head_depth = dec_head_depth,
         dec_tail_depth = 4,
-        enc_depth = 3,
+        enc_depth = 2,
         kl_loss_weight = 1.,
         per_token_latents = per_token_latents,
         latent_bits = 8
@@ -1434,3 +1436,20 @@ def test_free(
     loss.backward()
 
     assert aux_loss.numel() == 1
+
+def test_kv_input_residual():
+    attn = Decoder(
+        dim = 256,
+        depth = 2,
+        heads = 4,
+        cross_attend = True
+    )
+
+    tokens = torch.randn(3, 32, 256)
+    context = torch.randn(3, 64, 256)
+
+    condition = torch.randn(2, 3, 64, 256)
+
+    out = attn(tokens, context = context, cross_attn_kv_residuals = condition)
+
+    assert tokens.shape == out.shape

{x_transformers-2.11.7 → x_transformers-2.11.9}/x_transformers/free_transformer.py

@@ -197,7 +197,9 @@ class FreeTransformer(Module):
             pre_norm_has_final_norm = False,
             **kwargs,
             **dec_kwargs
-        )
+        ) if dec_head_depth > 0 else nn.Identity()
+
+        assert dec_tail_depth > 0
 
         self.decoder_tail = Decoder(
             dim = dim,
@@ -296,10 +298,7 @@ class FreeTransformer(Module):
 
             head_embed = self.decoder_head(tokens)
 
-            if exists(condition):
-                head_embed = head_embed + condition
-
-            tail_embed = self.decoder_tail(head_embed)
+            tail_embed = self.decoder_tail(head_embed, self_attn_kv_residuals = condition)
 
             tail_embed = tail_embed[:, -1]
 
@@ -339,7 +338,7 @@ class FreeTransformer(Module):
 
         # decoder tail
 
-        tokens = self.decoder_tail(tokens + condition)
+        tokens = self.decoder_tail(tokens, self_attn_kv_residuals = condition)
 
         # cross entropy loss
 

{x_transformers-2.11.7 → x_transformers-2.11.9}/x_transformers/x_transformers.py

@@ -1686,6 +1686,7 @@ class Attention(Module):
         value_residual = None,
         additional_key_values: tuple[Tensor, Tensor] | None = None,
         additional_key_value_mask = None,
+        kv_input_residual = None,
     ):
         b, n, h, kv_h, head_scale, num_mem_kv, device, has_context, qkv_receive_diff_residuals, is_multi_latent_attn = x.shape[0], x.shape[1], self.heads, self.kv_heads, self.head_scale, self.num_mem_kv, x.device, exists(context), self.qkv_receive_diff_residuals, self.use_latent_kv
 
@@ -1702,6 +1703,12 @@ class Attention(Module):
             kv_input = default(context, x)
             q_input, k_input, v_input = x, kv_input, kv_input
 
+        # done for free transformer
+
+        if exists(kv_input_residual):
+            k_input = k_input + kv_input_residual
+            v_input = v_input + kv_input_residual
+
         if exists(mem):
             k_input, mem_packed_shape = pack([mem, k_input], 'b * d')
             v_input, _ = pack([mem, v_input], 'b * d')
@@ -2543,7 +2550,9 @@ class AttentionLayers(Module):
         route_additional_kv_to_top = True,
         condition = None,
         in_attn_cond = None, # https://arxiv.org/abs/2105.04090
-        layers_execute_order: tuple[int, ...] | None = None
+        layers_execute_order: tuple[int, ...] | None = None,
+        self_attn_kv_residuals: Tensor | None = None,
+        cross_attn_kv_residuals: Tensor | None = None
     ):
         assert not (self.cross_attend ^ exists(context)), 'context must be passed in if cross_attend is set to True'
         assert not (exists(condition) ^ self.need_condition), 'condition needs to be passed in if using adaptive layernorm or vice versa'
@@ -2721,6 +2730,23 @@ class AttentionLayers(Module):
 
         skip_hiddens = []
 
+        # for residuals to key value inputs for self and cross attention
+
+        self_attn_kv_residuals_iter = iter((None,))
+        cross_attn_kv_residuals_iter = iter((None,))
+
+        if exists(self_attn_kv_residuals):
+            if self_attn_kv_residuals.ndim == 3:
+                self_attn_kv_residuals = rearrange(self_attn_kv_residuals, '... ->  1 ...')
+
+            self_attn_kv_residuals_iter = iter(self_attn_kv_residuals)
+
+        if exists(cross_attn_kv_residuals):
+            if cross_attn_kv_residuals.ndim == 3:
+                cross_attn_kv_residuals = rearrange(cross_attn_kv_residuals, '... ->  1 ...')
+
+            cross_attn_kv_residuals_iter = iter(cross_attn_kv_residuals)
+
         # for value residuals
 
         first_self_attn_inter = None
@@ -2794,9 +2820,9 @@ class AttentionLayers(Module):
             # forward depending on layer type
 
             if layer_type == 'a':
-                out, inter = block(x, mask = mask, context_mask = self_attn_kv_mask, attn_mask = attn_mask, rel_pos = self.rel_pos, pos = pos, rotary_pos_emb = rotary_pos_emb, additional_key_values = next(iter_self_attn_kv, None), additional_key_value_mask = additional_kv_mask, prev_attn = prev_attn, cache = next(iter_attn_cache, None), mem = layer_mem, mem_mask = layer_mem_mask, attn_bias = attn_bias, value_residual = maybe_self_attn_value_residual, return_intermediates = True)
+                out, inter = block(x, mask = mask, context_mask = self_attn_kv_mask, attn_mask = attn_mask, rel_pos = self.rel_pos, pos = pos, rotary_pos_emb = rotary_pos_emb, additional_key_values = next(iter_self_attn_kv, None), additional_key_value_mask = additional_kv_mask, prev_attn = prev_attn, cache = next(iter_attn_cache, None), mem = layer_mem, mem_mask = layer_mem_mask, attn_bias = attn_bias, kv_input_residual = next(self_attn_kv_residuals_iter, None), value_residual = maybe_self_attn_value_residual, return_intermediates = True)
             elif layer_type == 'c':
-                out, inter = block(x, context = context, mask = mask, context_mask = context_mask, prev_attn = prev_cross_attn, cache = next(iter_attn_cache, None), value_residual = maybe_cross_attn_value_residual, **cross_attn_rotary_pos_emb, return_intermediates = True)
+                out, inter = block(x, context = context, mask = mask, context_mask = context_mask, prev_attn = prev_cross_attn, cache = next(iter_attn_cache, None), kv_input_residual = next(cross_attn_kv_residuals_iter, None), value_residual = maybe_cross_attn_value_residual, **cross_attn_rotary_pos_emb, return_intermediates = True)
             elif layer_type == 'f':
                 out = block(x, deep_embed = next(deep_embeds_iter, None))