#!/usr/bin/env python3 """Export Cohere decoder using masking instead of slicing.""" import argparse import sys from pathlib import Path import coremltools as ct import numpy as np import torch import torch.nn as nn from transformers import AutoModelForSpeechSeq2Seq from transformers.cache_utils import DynamicCache, EncoderDecoderCache class MaskedCachedDecoderWrapper(nn.Module): """Use masking instead of slicing to handle variable-length cache.""" def __init__(self, full_model, max_seq_len=108): super().__init__() self.decoder = full_model.transf_decoder self.log_softmax = full_model.log_softmax dec_config = full_model.config.transf_decoder["config_dict"] self.num_layers = dec_config["num_layers"] self.num_heads = dec_config["num_attention_heads"] self.hidden_size = dec_config["hidden_size"] self.head_dim = self.hidden_size // self.num_heads self.max_seq_len = max_seq_len def forward(self, input_id, encoder_hidden_states, cache_k, cache_v, step, cross_attention_mask): """ Use masking to zero out invalid cache positions instead of slicing. The decoder will receive full-size cache, but positions > step are zeroed. Combined with attention masking, this should be equivalent to truncation. """ batch_size = 1 # Create binary mask: 1 for positions < step, 0 for positions >= step # Shape: (1, 1, max_seq_len, 1) positions = torch.arange(self.max_seq_len, device=input_id.device).view(1, 1, -1, 1) step_expanded = step.view(1, 1, 1, 1) valid_mask = (positions < step_expanded).float() # (1, 1, 108, 1) # Build cache with masking self_attention_cache = DynamicCache() cross_attention_cache = DynamicCache() for layer_idx in range(self.num_layers): layer_k = cache_k[layer_idx].unsqueeze(0) # (1, 8, 108, 128) layer_v = cache_v[layer_idx].unsqueeze(0) # Zero out positions >= step layer_k_masked = layer_k * valid_mask # Broadcasting: (1, 8, 108, 128) * (1, 1, 108, 1) layer_v_masked = layer_v * valid_mask self_attention_cache.update(layer_k_masked, layer_v_masked, layer_idx) past_key_values = EncoderDecoderCache(self_attention_cache, cross_attention_cache) # Positions tensor positions_input = step.view(1, 1).long() # Attention mask - mask positions >= step # Make it max_seq_len + 1 to handle the new position being added mask_len = self.max_seq_len + 1 # 109 to handle appending pos_range = torch.arange(mask_len, device=input_id.device).view(1, 1, 1, -1) step_exp = step.view(1, 1, 1, 1) should_mask = pos_range >= step_exp # (1, 1, 1, 109) self_attention_mask = torch.where( should_mask, torch.full((1, 1, 1, mask_len), float("-inf"), device=input_id.device, dtype=encoder_hidden_states.dtype), torch.zeros((1, 1, 1, mask_len), device=input_id.device, dtype=encoder_hidden_states.dtype) ) # Cross attention mask cross_mask_reshaped = cross_attention_mask.squeeze(1).squeeze(1) # Decoder call decoder_outputs, updated_cache = self.decoder( input_ids=input_id, positions=positions_input, encoder_hidden_states=encoder_hidden_states, self_attention_mask=self_attention_mask, cross_attention_mask=cross_mask_reshaped, past_key_values=past_key_values, cache_position=None, kv_seq_len=None, ) # Get logits logits = self.log_softmax(decoder_outputs).squeeze(1) # Extract and pad cache self_attn_cache = updated_cache.self_attention_cache new_cache_k_list = [] new_cache_v_list = [] for layer_idx in range(self.num_layers): layer_k = self_attn_cache.key_cache[layer_idx].squeeze(0) layer_v = self_attn_cache.value_cache[layer_idx].squeeze(0) # Pad to max_seq_len (or truncate if too long) current_len = layer_k.shape[1] if current_len < self.max_seq_len: pad_len = self.max_seq_len - current_len layer_k = torch.nn.functional.pad(layer_k, (0, 0, 0, pad_len)) layer_v = torch.nn.functional.pad(layer_v, (0, 0, 0, pad_len)) elif current_len > self.max_seq_len: layer_k = layer_k[:, :self.max_seq_len, :] layer_v = layer_v[:, :self.max_seq_len, :] new_cache_k_list.append(layer_k) new_cache_v_list.append(layer_v) new_cache_k = torch.stack(new_cache_k_list, dim=0) new_cache_v = torch.stack(new_cache_v_list, dim=0) return logits, new_cache_k, new_cache_v def export_decoder_cached(output_dir: Path, precision: str = "float16"): print("="*70) print("Cohere Decoder Export - Masking Approach") print("="*70) output_dir.mkdir(parents=True, exist_ok=True) print("\n[1/5] Loading model...") model = AutoModelForSpeechSeq2Seq.from_pretrained( "CohereLabs/cohere-transcribe-03-2026", trust_remote_code=True, torch_dtype=torch.float32, ) model.eval() print(" āœ“ Loaded") print("\n[2/5] Wrapping decoder...") wrapped = MaskedCachedDecoderWrapper(model, max_seq_len=108) wrapped.eval() print(" āœ“ Wrapped") print("\n[3/5] Creating inputs...") example_input_id = torch.tensor([[13764]], dtype=torch.long) example_encoder_hidden = torch.randn(1, 376, 1024) example_cache_k = torch.zeros(8, 8, 108, 128) example_cache_v = torch.zeros(8, 8, 108, 128) example_step = torch.tensor([0], dtype=torch.int32) example_cross_mask = torch.ones(1, 1, 1, 376) print("\n[4/5] Tracing...") with torch.no_grad(): traced = torch.jit.trace( wrapped, (example_input_id, example_encoder_hidden, example_cache_k, example_cache_v, example_step, example_cross_mask), check_trace=False, ) logits, k, v = traced(example_input_id, example_encoder_hidden, example_cache_k, example_cache_v, example_step, example_cross_mask) print(f" Output: logits={logits.shape}, cache={k.shape}") print(f"\n[5/5] Converting to CoreML ({precision})...") inputs = [ ct.TensorType(name="input_id", shape=example_input_id.shape, dtype=np.int32), ct.TensorType(name="encoder_hidden_states", shape=example_encoder_hidden.shape, dtype=np.float32), ct.TensorType(name="cache_k", shape=example_cache_k.shape, dtype=np.float32), ct.TensorType(name="cache_v", shape=example_cache_v.shape, dtype=np.float32), ct.TensorType(name="step", shape=example_step.shape, dtype=np.int32), ct.TensorType(name="cross_attention_mask", shape=example_cross_mask.shape, dtype=np.float32), ] compute_precision = ct.precision.FLOAT16 if precision == "float16" else ct.precision.FLOAT32 mlmodel = ct.convert( traced, inputs=inputs, outputs=[ ct.TensorType(name="logits"), ct.TensorType(name="new_cache_k"), ct.TensorType(name="new_cache_v"), ], minimum_deployment_target=ct.target.iOS17, compute_precision=compute_precision, ) output_path = output_dir / "cohere_decoder_cached.mlpackage" mlmodel.save(str(output_path)) size_mb = sum(f.stat().st_size for f in output_path.rglob('*') if f.is_file()) / 1024**2 print(f" āœ“ Saved: {output_path}") print(f" Size: {size_mb:.1f} MB") print("\n" + "="*70) print("EXPORT COMPLETE") print("="*70) def main(): parser = argparse.ArgumentParser() parser.add_argument("--output-dir", type=Path, default=Path("build")) parser.add_argument("--precision", choices=["float16", "float32"], default="float16") args = parser.parse_args() try: export_decoder_cached(args.output_dir, args.precision) except Exception as e: print(f"\nāŒ Failed: {e}", file=sys.stderr) import traceback traceback.print_exc() sys.exit(1) if __name__ == "__main__": main()