titans-pytorch 0.2.17__tar.gz → 0.2.19__tar.gz

{titans_pytorch-0.2.17 → titans_pytorch-0.2.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: titans-pytorch
-Version: 0.2.17
+Version: 0.2.19
 Summary: Titans
 Project-URL: Homepage, https://pypi.org/project/titans-pytorch/
 Project-URL: Repository, https://github.com/lucidrains/titans-pytorch

{titans_pytorch-0.2.17 → titans_pytorch-0.2.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "titans-pytorch"
-version = "0.2.17"
+version = "0.2.19"
 description = "Titans"
 authors = [
     { name = "Phil Wang", email = "lucidrains@gmail.com" }

{titans_pytorch-0.2.17 → titans_pytorch-0.2.19}/tests/test_titans.py

@@ -105,7 +105,8 @@ def test_neural_mem_chaining_with_weight_residual():
         dim = 384,
         dim_head = 64,
         heads = 2,
-        chunk_size = 64
+        chunk_size = 64,
+        accept_weight_residual = True
     )
 
     seq = torch.randn(2, 256, 384)
@@ -149,6 +150,7 @@ def test_neural_mem_chaining_with_batch_size():
 @pytest.mark.parametrize('num_longterm_mem_tokens', (0, 16))
 @pytest.mark.parametrize('neural_mem_gate_attn_output', (False, True))
 @pytest.mark.parametrize('neural_mem_segment_len', (8, 16))
+@pytest.mark.parametrize('neural_mem_weight_residual', (False, True))
 @pytest.mark.parametrize('neural_mem_batch_size', (None, 64))
 def test_mac(
     seq_len,
@@ -156,7 +158,8 @@ def test_mac(
     num_longterm_mem_tokens,
     neural_mem_gate_attn_output,
     neural_mem_segment_len,
-    neural_mem_batch_size
+    neural_mem_weight_residual,
+    neural_mem_batch_size,
 ):
     transformer = MemoryAsContextTransformer(
         num_tokens = 256,
@@ -168,6 +171,7 @@ def test_mac(
         neural_mem_gate_attn_output = neural_mem_gate_attn_output,
         neural_memory_segment_len = neural_mem_segment_len,
         neural_memory_batch_size = neural_mem_batch_size,
+        neural_mem_weight_residual = neural_mem_weight_residual
     )
 
     x = torch.randint(0, 256, (1, seq_len))

{titans_pytorch-0.2.17 → titans_pytorch-0.2.19}/titans_pytorch/mac_transformer.py

@@ -491,7 +491,7 @@ class MemoryAsContextTransformer(Module):
         neural_memory_layers: tuple[int, ...] | None = None,
         use_flex_attn = False,
         sliding_window_attn = False,
-        neural_mem_weight_residual = False
+        neural_mem_weight_residual = False,
     ):
         super().__init__()
 
@@ -525,7 +525,10 @@ class MemoryAsContextTransformer(Module):
 
         neural_memory_layers = default(neural_memory_layers, layers)
 
+        # weight residual related
+
         self.neural_mem_weight_residual = neural_mem_weight_residual
+        is_first_neural_mem = True
 
         # mem, attn, and feedforward layers
 
@@ -557,9 +560,12 @@ class MemoryAsContextTransformer(Module):
                     chunk_size = self.neural_memory_segment_len,
                     batch_size = neural_memory_batch_size,
                     model = deepcopy(neural_memory_model),
+                    learned_weight_residual = neural_mem_weight_residual and not is_first_neural_mem,
                     **neural_memory_kwargs
                 )
 
+                is_first_neural_mem = False
+
             ff = FeedForward(dim = dim, mult = ff_mult)
 
             self.layers.append(ModuleList([

{titans_pytorch-0.2.17 → titans_pytorch-0.2.19}/titans_pytorch/neural_memory.py

@@ -66,6 +66,12 @@ def xnor(x, y):
 def divisible_by(num, den):
     return (num % den) == 0
 
+def tuple_index_set(t: tuple, index, value):
+    klass = type(t)
+    t = list(t)
+    t[index] = value
+    return klass(*t)
+
 def safe_cat(inputs, dim = -2):
     inputs = tuple(filter(exists, inputs))
 
@@ -296,6 +302,7 @@ class NeuralMemory(Module):
         init_adaptive_step_bias = None,
         init_momentum_bias = None,
         init_decay_bias = None,
+        accept_weight_residual = False,
         default_model_kwargs: dict = dict(
             depth = 2
         )
@@ -438,6 +445,14 @@ class NeuralMemory(Module):
 
         self.max_mem_layer_modulation = max_mem_layer_modulation
 
+        # learned weight residual
+
+        self.to_learned_weight_residual_mix = Sequential(
+            nn.Linear(dim, heads),
+            Rearrange('b n h -> b h n'),
+            nn.Sigmoid()
+        ) if accept_weight_residual else None
+
         # allow for softclamp the gradient norms for storing memories
 
         self.max_grad_norm = max_grad_norm
@@ -563,6 +578,8 @@ class NeuralMemory(Module):
 
         # maybe add previous layer weight
 
+        assert xnor(exists(self.to_learned_weight_residual_mix), exists(prev_weights))
+
         if exists(prev_weights):
 
             start_index = math.ceil(seq_index / chunk_size)
@@ -570,6 +587,11 @@ class NeuralMemory(Module):
 
             prev_weights = prev_weights.apply(lambda t: t[:, start_index:end_index])
 
+            if exists(self.to_learned_weight_residual_mix):
+                mix = self.to_learned_weight_residual_mix(chunked_seq)
+                mix = rearrange(mix, 'b h n -> (b h) n')
+                prev_weights = prev_weights.apply(lambda t: einx.multiply('bh n, bh n ... -> bh n ...', mix, t))
+
             weights_for_surprise = weights_for_surprise + prev_weights
 
         # flatten batch and time if surprise depends on previous layer memory model
@@ -837,9 +859,9 @@ class NeuralMemory(Module):
 
             weights = last_update
 
-            next_neural_mem_state = list(next_neural_mem_state)
-            next_neural_mem_state[1] = last_update
-            next_neural_mem_state = NeuralMemCache(*next_neural_mem_state)
+            next_neural_mem_state = tuple_index_set(next_neural_mem_state, 1, last_update)
+
+        next_neural_mem_state = tuple_index_set(next_neural_mem_state, -1, updates)
 
         # retrieve