Kernels:

kernels-community
/

metal-flash-sdpa

Trusted publisher

Kernel card Files Files and versions

xet

Community

kernels-bot commited on 19 days ago

Commit

e338c69

verified ·

1 Parent(s): b8358f7

Uploaded using `kernel-builder`.

Browse files

Files changed (12) hide show

build/torch210-metal-aarch64-darwin/{_metal_flash_sdpa_metal_86f75d9.abi3.so → _metal_flash_sdpa_metal_9cd92d8.abi3.so} +1 -1
build/torch210-metal-aarch64-darwin/_ops.py +3 -3
build/torch210-metal-aarch64-darwin/metadata.json +1 -1
build/torch211-metal-aarch64-darwin/{_metal_flash_sdpa_metal_86f75d9.abi3.so → _metal_flash_sdpa_metal_9cd92d8.abi3.so} +1 -1
build/torch211-metal-aarch64-darwin/_ops.py +3 -3
build/torch211-metal-aarch64-darwin/metadata.json +1 -1
build/torch212-metal-aarch64-darwin/__init__.py +11 -0
build/torch212-metal-aarch64-darwin/_custom_ops.py +117 -0
build/torch212-metal-aarch64-darwin/_metal_flash_sdpa_metal_9cd92d8.abi3.so +3 -0
build/torch212-metal-aarch64-darwin/_ops.py +9 -0
build/torch212-metal-aarch64-darwin/metadata.json +10 -0
build/torch212-metal-aarch64-darwin/metal_flash_sdpa/__init__.py +26 -0

build/torch210-metal-aarch64-darwin/{_metal_flash_sdpa_metal_86f75d9.abi3.so → _metal_flash_sdpa_metal_9cd92d8.abi3.so} RENAMED Viewed

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:93b229fbb70ab8aac276c29432a9bd5f2d2e93b1a7616f8ba43b5faee973e6db
 size 733096

 version https://git-lfs.github.com/spec/v1
+oid sha256:b752a49d80853771401a1dca88334750d2891aaaab83944eafe6593590054ef8
 size 733096

build/torch210-metal-aarch64-darwin/_ops.py CHANGED Viewed

@@ -1,9 +1,9 @@
 import torch
-from . import _metal_flash_sdpa_metal_86f75d9
-ops = torch.ops._metal_flash_sdpa_metal_86f75d9
 def add_op_namespace_prefix(op_name: str):
     """
     Prefix op by namespace.
     """
-    return f"_metal_flash_sdpa_metal_86f75d9::{op_name}"

 import torch
+from . import _metal_flash_sdpa_metal_9cd92d8
+ops = torch.ops._metal_flash_sdpa_metal_9cd92d8
 def add_op_namespace_prefix(op_name: str):
     """
     Prefix op by namespace.
     """
+    return f"_metal_flash_sdpa_metal_9cd92d8::{op_name}"

build/torch210-metal-aarch64-darwin/metadata.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "metal-flash-sdpa",
-  "id": "_metal_flash_sdpa_metal_86f75d9",
   "version": 1,
   "license": "Apache-2.0",
   "python-depends": [],

 {
   "name": "metal-flash-sdpa",
+  "id": "_metal_flash_sdpa_metal_9cd92d8",
   "version": 1,
   "license": "Apache-2.0",
   "python-depends": [],

build/torch211-metal-aarch64-darwin/{_metal_flash_sdpa_metal_86f75d9.abi3.so → _metal_flash_sdpa_metal_9cd92d8.abi3.so} RENAMED Viewed

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:b9c5200deaf10bcc115281247d9f9682b53fe742017a64eaa222f5daf1388205
 size 733096

 version https://git-lfs.github.com/spec/v1
+oid sha256:1c08a5fc159619cf1c817422b75ce9e8b9976eebb67f3c9df92594e44487a759
 size 733096

build/torch211-metal-aarch64-darwin/_ops.py CHANGED Viewed

@@ -1,9 +1,9 @@
 import torch
-from . import _metal_flash_sdpa_metal_86f75d9
-ops = torch.ops._metal_flash_sdpa_metal_86f75d9
 def add_op_namespace_prefix(op_name: str):
     """
     Prefix op by namespace.
     """
-    return f"_metal_flash_sdpa_metal_86f75d9::{op_name}"

 import torch
+from . import _metal_flash_sdpa_metal_9cd92d8
+ops = torch.ops._metal_flash_sdpa_metal_9cd92d8
 def add_op_namespace_prefix(op_name: str):
     """
     Prefix op by namespace.
     """
+    return f"_metal_flash_sdpa_metal_9cd92d8::{op_name}"

build/torch211-metal-aarch64-darwin/metadata.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "metal-flash-sdpa",
-  "id": "_metal_flash_sdpa_metal_86f75d9",
   "version": 1,
   "license": "Apache-2.0",
   "python-depends": [],

 {
   "name": "metal-flash-sdpa",
+  "id": "_metal_flash_sdpa_metal_9cd92d8",
   "version": 1,
   "license": "Apache-2.0",
   "python-depends": [],

build/torch212-metal-aarch64-darwin/__init__.py ADDED Viewed

	@@ -0,0 +1,11 @@

+from ._custom_ops import (
+    flash_attention_varlen,
+    flash_attn_varlen_func,
+)
+from ._ops import ops
+__all__ = [
+    "flash_attention_varlen",
+    "flash_attn_varlen_func",
+    "ops",
+]

build/torch212-metal-aarch64-darwin/_custom_ops.py ADDED Viewed

	@@ -0,0 +1,117 @@

+from typing import List, Optional
+import torch
+from ._ops import ops
+def flash_attention_varlen(
+    out: torch.Tensor,
+    query: torch.Tensor,
+    key: torch.Tensor,
+    value: torch.Tensor,
+    cu_seqlens_q: torch.Tensor,
+    cu_seqlens_k: torch.Tensor,
+    max_seqlen_q: int,
+    max_seqlen_k: int,
+    do_causal: bool = False,
+    scale: Optional[float] = None,
+    softcapping: float = 1.0,
+) -> None:
+    """
+    Flash Attention with variable-length sequences.
+    Args:
+        out: Output tensor of shape [total_q_tokens, num_heads, head_dim]
+        query: Query tensor of shape [total_q_tokens, num_heads, head_dim]
+        key: Key tensor of shape [total_k_tokens, num_heads_kv, head_dim]
+        value: Value tensor of shape [total_k_tokens, num_heads_kv, head_dim]
+        cu_seqlens_q: Cumulative sequence lengths for queries, shape [batch_size + 1], dtype must be torch.int32
+        cu_seqlens_k: Cumulative sequence lengths for keys, shape [batch_size + 1], dtype must be torch.int32
+        max_seqlen_q: Maximum sequence length in the query batch
+        max_seqlen_k: Maximum sequence length in the key batch
+        do_causal: Whether to apply causal masking
+        scale: Attention scale factor (default: 1/sqrt(head_dim))
+        softcapping: Softcapping value (default: 1.0, must be 1.0 for this implementation)
+    Note:
+        - cu_seqlens_q and cu_seqlens_k must have dtype torch.int32 for Metal compatibility
+        - Supported head dimensions: 32, 64, 72, 80, 96, 128
+        - Masks are not supported
+    """
+    if scale is None:
+        scale = query.shape[-1] ** -0.5
+    ops.flash_attention_varlen(
+        out,
+        query,
+        key,
+        value,
+        cu_seqlens_q,
+        cu_seqlens_k,
+        max_seqlen_q,
+        max_seqlen_k,
+        do_causal,
+        scale,
+        softcapping,
+    )
+def flash_attn_varlen_func(
+    q: torch.Tensor,
+    k: torch.Tensor,
+    v: torch.Tensor,
+    cu_seqlens_q: torch.Tensor,
+    cu_seqlens_k: torch.Tensor,
+    max_seqlen_q: int,
+    max_seqlen_k: int,
+    dropout_p: float = 0.0,
+    softmax_scale: Optional[float] = None,
+    causal: bool = False,
+    window_size: tuple = (-1, -1),
+    alibi_slopes: Optional[torch.Tensor] = None,
+    deterministic: bool = False,
+    return_attn_probs: bool = False,
+) -> torch.Tensor:
+    """
+    Flash Attention function with API compatible with the original Flash Attention.
+    Note: This implementation does not support:
+    - dropout
+    - window attention
+    - alibi slopes
+    - returning attention probabilities
+    """
+    if dropout_p > 0:
+        raise NotImplementedError("Dropout is not supported in this implementation")
+    if window_size != (-1, -1):
+        raise NotImplementedError("Window attention is not supported")
+    if alibi_slopes is not None:
+        raise NotImplementedError("ALiBi is not supported")
+    if return_attn_probs:
+        raise NotImplementedError("Returning attention probabilities is not supported")
+    # Create output tensor
+    out = torch.empty_like(q)
+    # Call the kernel
+    flash_attention_varlen(
+        out=out,
+        query=q,
+        key=k,
+        value=v,
+        cu_seqlens_q=cu_seqlens_q,
+        cu_seqlens_k=cu_seqlens_k,
+        max_seqlen_q=max_seqlen_q,
+        max_seqlen_k=max_seqlen_k,
+        do_causal=causal,
+        scale=softmax_scale,
+        softcapping=1.0,
+    )
+    return out
+__all__ = [
+    "flash_attention_varlen",
+    "flash_attn_varlen_func",
+]

build/torch212-metal-aarch64-darwin/_metal_flash_sdpa_metal_9cd92d8.abi3.so ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:8cc31f8453fb18e703bb77d1ea793c8039d14156078eda8c20713af96a7e2e9c
+size 733128

build/torch212-metal-aarch64-darwin/_ops.py ADDED Viewed

	@@ -0,0 +1,9 @@

+import torch
+from . import _metal_flash_sdpa_metal_9cd92d8
+ops = torch.ops._metal_flash_sdpa_metal_9cd92d8
+def add_op_namespace_prefix(op_name: str):
+    """
+    Prefix op by namespace.
+    """
+    return f"_metal_flash_sdpa_metal_9cd92d8::{op_name}"

build/torch212-metal-aarch64-darwin/metadata.json ADDED Viewed

	@@ -0,0 +1,10 @@

+{
+  "name": "metal-flash-sdpa",
+  "id": "_metal_flash_sdpa_metal_9cd92d8",
+  "version": 1,
+  "license": "Apache-2.0",
+  "python-depends": [],
+  "backend": {
+    "type": "metal"
+  }
+}

build/torch212-metal-aarch64-darwin/metal_flash_sdpa/__init__.py ADDED Viewed

	@@ -0,0 +1,26 @@

+import ctypes
+import importlib.util
+import sys
+from pathlib import Path
+from types import ModuleType
+def _import_from_path(file_path: Path) -> ModuleType:
+    # We cannot use the module name as-is, after adding it to `sys.modules`,
+    # it would also be used for other imports. So, we make a module name that
+    # depends on the path for it to be unique using the hex-encoded hash of
+    # the path.
+    path_hash = "{:x}".format(ctypes.c_size_t(hash(file_path.absolute())).value)
+    module_name = path_hash
+    spec = importlib.util.spec_from_file_location(module_name, file_path)
+    if spec is None:
+        raise ImportError(f"Cannot load spec for {module_name} from {file_path}")
+    module = importlib.util.module_from_spec(spec)
+    if module is None:
+        raise ImportError(f"Cannot load module {module_name} from spec")
+    sys.modules[module_name] = module
+    spec.loader.exec_module(module)  # type: ignore
+    return module
+globals().update(vars(_import_from_path(Path(__file__).parent.parent / "__init__.py")))