mlx 0.30.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (599) hide show
  1. checksums.yaml +7 -0
  2. data/ext/mlx/extconf.rb +94 -0
  3. data/ext/mlx/native.cpp +8027 -0
  4. data/lib/mlx/core.rb +1678 -0
  5. data/lib/mlx/distributed_utils/common.rb +116 -0
  6. data/lib/mlx/distributed_utils/config.rb +600 -0
  7. data/lib/mlx/distributed_utils/launch.rb +490 -0
  8. data/lib/mlx/extension.rb +24 -0
  9. data/lib/mlx/nn/base.rb +388 -0
  10. data/lib/mlx/nn/init.rb +140 -0
  11. data/lib/mlx/nn/layers/activations.rb +336 -0
  12. data/lib/mlx/nn/layers/base.rb +6 -0
  13. data/lib/mlx/nn/layers/containers.rb +20 -0
  14. data/lib/mlx/nn/layers/convolution.rb +120 -0
  15. data/lib/mlx/nn/layers/convolution_transpose.rb +114 -0
  16. data/lib/mlx/nn/layers/distributed.rb +309 -0
  17. data/lib/mlx/nn/layers/dropout.rb +75 -0
  18. data/lib/mlx/nn/layers/embedding.rb +28 -0
  19. data/lib/mlx/nn/layers/linear.rb +79 -0
  20. data/lib/mlx/nn/layers/normalization.rb +216 -0
  21. data/lib/mlx/nn/layers/pooling.rb +167 -0
  22. data/lib/mlx/nn/layers/positional_encoding.rb +126 -0
  23. data/lib/mlx/nn/layers/quantized.rb +215 -0
  24. data/lib/mlx/nn/layers/recurrent.rb +135 -0
  25. data/lib/mlx/nn/layers/transformer.rb +330 -0
  26. data/lib/mlx/nn/layers/upsample.rb +97 -0
  27. data/lib/mlx/nn/layers.rb +18 -0
  28. data/lib/mlx/nn/losses.rb +251 -0
  29. data/lib/mlx/nn/utils.rb +167 -0
  30. data/lib/mlx/nn.rb +12 -0
  31. data/lib/mlx/optimizers/optimizers.rb +808 -0
  32. data/lib/mlx/optimizers/schedulers.rb +62 -0
  33. data/lib/mlx/optimizers.rb +9 -0
  34. data/lib/mlx/utils.rb +171 -0
  35. data/lib/mlx/version.rb +5 -0
  36. data/lib/mlx.rb +64 -0
  37. data/mlx/CMakeLists.txt +449 -0
  38. data/mlx/cmake/FindCUDNN.cmake +177 -0
  39. data/mlx/cmake/FindNCCL.cmake +54 -0
  40. data/mlx/cmake/Findnvpl.cmake +3 -0
  41. data/mlx/cmake/extension.cmake +50 -0
  42. data/mlx/mlx/3rdparty/.clang-format +2 -0
  43. data/mlx/mlx/3rdparty/pocketfft.h +3581 -0
  44. data/mlx/mlx/CMakeLists.txt +107 -0
  45. data/mlx/mlx/allocator.h +75 -0
  46. data/mlx/mlx/api.h +29 -0
  47. data/mlx/mlx/array.cpp +354 -0
  48. data/mlx/mlx/array.h +647 -0
  49. data/mlx/mlx/backend/common/CMakeLists.txt +9 -0
  50. data/mlx/mlx/backend/common/binary.h +97 -0
  51. data/mlx/mlx/backend/common/broadcasting.cpp +24 -0
  52. data/mlx/mlx/backend/common/broadcasting.h +11 -0
  53. data/mlx/mlx/backend/common/buffer_cache.h +158 -0
  54. data/mlx/mlx/backend/common/common.cpp +305 -0
  55. data/mlx/mlx/backend/common/compiled.cpp +243 -0
  56. data/mlx/mlx/backend/common/compiled.h +77 -0
  57. data/mlx/mlx/backend/common/copy.h +50 -0
  58. data/mlx/mlx/backend/common/hadamard.h +109 -0
  59. data/mlx/mlx/backend/common/load.cpp +57 -0
  60. data/mlx/mlx/backend/common/matmul.h +67 -0
  61. data/mlx/mlx/backend/common/reduce.cpp +154 -0
  62. data/mlx/mlx/backend/common/reduce.h +59 -0
  63. data/mlx/mlx/backend/common/slicing.cpp +71 -0
  64. data/mlx/mlx/backend/common/slicing.h +20 -0
  65. data/mlx/mlx/backend/common/ternary.h +85 -0
  66. data/mlx/mlx/backend/common/unary.h +29 -0
  67. data/mlx/mlx/backend/common/utils.cpp +231 -0
  68. data/mlx/mlx/backend/common/utils.h +205 -0
  69. data/mlx/mlx/backend/cpu/CMakeLists.txt +88 -0
  70. data/mlx/mlx/backend/cpu/arange.h +28 -0
  71. data/mlx/mlx/backend/cpu/arg_reduce.cpp +124 -0
  72. data/mlx/mlx/backend/cpu/binary.cpp +269 -0
  73. data/mlx/mlx/backend/cpu/binary.h +517 -0
  74. data/mlx/mlx/backend/cpu/binary_ops.h +98 -0
  75. data/mlx/mlx/backend/cpu/binary_two.h +166 -0
  76. data/mlx/mlx/backend/cpu/cholesky.cpp +85 -0
  77. data/mlx/mlx/backend/cpu/compiled.cpp +357 -0
  78. data/mlx/mlx/backend/cpu/compiled_preamble.h +12 -0
  79. data/mlx/mlx/backend/cpu/conv.cpp +1351 -0
  80. data/mlx/mlx/backend/cpu/copy.cpp +386 -0
  81. data/mlx/mlx/backend/cpu/copy.h +36 -0
  82. data/mlx/mlx/backend/cpu/device_info.cpp +113 -0
  83. data/mlx/mlx/backend/cpu/device_info.h +28 -0
  84. data/mlx/mlx/backend/cpu/distributed.cpp +103 -0
  85. data/mlx/mlx/backend/cpu/eig.cpp +281 -0
  86. data/mlx/mlx/backend/cpu/eigh.cpp +241 -0
  87. data/mlx/mlx/backend/cpu/encoder.cpp +16 -0
  88. data/mlx/mlx/backend/cpu/encoder.h +67 -0
  89. data/mlx/mlx/backend/cpu/eval.cpp +40 -0
  90. data/mlx/mlx/backend/cpu/eval.h +12 -0
  91. data/mlx/mlx/backend/cpu/fft.cpp +120 -0
  92. data/mlx/mlx/backend/cpu/gemm.h +26 -0
  93. data/mlx/mlx/backend/cpu/gemms/bnns.cpp +214 -0
  94. data/mlx/mlx/backend/cpu/gemms/cblas.cpp +134 -0
  95. data/mlx/mlx/backend/cpu/gemms/simd_bf16.cpp +45 -0
  96. data/mlx/mlx/backend/cpu/gemms/simd_fp16.cpp +45 -0
  97. data/mlx/mlx/backend/cpu/gemms/simd_gemm.h +139 -0
  98. data/mlx/mlx/backend/cpu/hadamard.cpp +121 -0
  99. data/mlx/mlx/backend/cpu/indexing.cpp +854 -0
  100. data/mlx/mlx/backend/cpu/inverse.cpp +160 -0
  101. data/mlx/mlx/backend/cpu/jit_compiler.cpp +166 -0
  102. data/mlx/mlx/backend/cpu/jit_compiler.h +20 -0
  103. data/mlx/mlx/backend/cpu/lapack.h +80 -0
  104. data/mlx/mlx/backend/cpu/logsumexp.cpp +139 -0
  105. data/mlx/mlx/backend/cpu/luf.cpp +120 -0
  106. data/mlx/mlx/backend/cpu/make_compiled_preamble.ps1 +38 -0
  107. data/mlx/mlx/backend/cpu/make_compiled_preamble.sh +41 -0
  108. data/mlx/mlx/backend/cpu/masked_mm.cpp +608 -0
  109. data/mlx/mlx/backend/cpu/matmul.cpp +166 -0
  110. data/mlx/mlx/backend/cpu/primitives.cpp +478 -0
  111. data/mlx/mlx/backend/cpu/qrf.cpp +147 -0
  112. data/mlx/mlx/backend/cpu/quantized.cpp +1370 -0
  113. data/mlx/mlx/backend/cpu/reduce.cpp +587 -0
  114. data/mlx/mlx/backend/cpu/scan.cpp +338 -0
  115. data/mlx/mlx/backend/cpu/select.cpp +95 -0
  116. data/mlx/mlx/backend/cpu/simd/accelerate_fp16_simd.h +56 -0
  117. data/mlx/mlx/backend/cpu/simd/accelerate_simd.h +329 -0
  118. data/mlx/mlx/backend/cpu/simd/base_simd.h +319 -0
  119. data/mlx/mlx/backend/cpu/simd/math.h +193 -0
  120. data/mlx/mlx/backend/cpu/simd/neon_fp16_simd.h +212 -0
  121. data/mlx/mlx/backend/cpu/simd/simd.h +4 -0
  122. data/mlx/mlx/backend/cpu/simd/type.h +11 -0
  123. data/mlx/mlx/backend/cpu/slicing.h +21 -0
  124. data/mlx/mlx/backend/cpu/softmax.cpp +170 -0
  125. data/mlx/mlx/backend/cpu/sort.cpp +481 -0
  126. data/mlx/mlx/backend/cpu/svd.cpp +289 -0
  127. data/mlx/mlx/backend/cpu/ternary.h +154 -0
  128. data/mlx/mlx/backend/cpu/threefry.cpp +31 -0
  129. data/mlx/mlx/backend/cpu/threefry.h +21 -0
  130. data/mlx/mlx/backend/cpu/unary.cpp +238 -0
  131. data/mlx/mlx/backend/cpu/unary.h +281 -0
  132. data/mlx/mlx/backend/cpu/unary_ops.h +175 -0
  133. data/mlx/mlx/backend/cuda/CMakeLists.txt +265 -0
  134. data/mlx/mlx/backend/cuda/allocator.cpp +451 -0
  135. data/mlx/mlx/backend/cuda/allocator.h +94 -0
  136. data/mlx/mlx/backend/cuda/arange.cu +68 -0
  137. data/mlx/mlx/backend/cuda/arg_reduce.cu +189 -0
  138. data/mlx/mlx/backend/cuda/bin2h.cmake +150 -0
  139. data/mlx/mlx/backend/cuda/binary/CMakeLists.txt +21 -0
  140. data/mlx/mlx/backend/cuda/binary/add.cu +7 -0
  141. data/mlx/mlx/backend/cuda/binary/arctan2.cu +7 -0
  142. data/mlx/mlx/backend/cuda/binary/binary.cuh +383 -0
  143. data/mlx/mlx/backend/cuda/binary/bitwise_binary.cu +27 -0
  144. data/mlx/mlx/backend/cuda/binary/divide.cu +7 -0
  145. data/mlx/mlx/backend/cuda/binary/equal.cu +15 -0
  146. data/mlx/mlx/backend/cuda/binary/greater.cu +7 -0
  147. data/mlx/mlx/backend/cuda/binary/greater_equal.cu +7 -0
  148. data/mlx/mlx/backend/cuda/binary/less.cu +7 -0
  149. data/mlx/mlx/backend/cuda/binary/less_equal.cu +7 -0
  150. data/mlx/mlx/backend/cuda/binary/log_add_exp.cu +7 -0
  151. data/mlx/mlx/backend/cuda/binary/logical_and.cu +7 -0
  152. data/mlx/mlx/backend/cuda/binary/logical_or.cu +7 -0
  153. data/mlx/mlx/backend/cuda/binary/maximum.cu +7 -0
  154. data/mlx/mlx/backend/cuda/binary/minimum.cu +7 -0
  155. data/mlx/mlx/backend/cuda/binary/multiply.cu +7 -0
  156. data/mlx/mlx/backend/cuda/binary/not_equal.cu +7 -0
  157. data/mlx/mlx/backend/cuda/binary/power.cu +7 -0
  158. data/mlx/mlx/backend/cuda/binary/remainder.cu +7 -0
  159. data/mlx/mlx/backend/cuda/binary/subtract.cu +7 -0
  160. data/mlx/mlx/backend/cuda/binary_two.cu +412 -0
  161. data/mlx/mlx/backend/cuda/compiled.cpp +357 -0
  162. data/mlx/mlx/backend/cuda/conv/conv.h +126 -0
  163. data/mlx/mlx/backend/cuda/conv/gemm_conv.cu +217 -0
  164. data/mlx/mlx/backend/cuda/conv/gemm_grouped_conv.cu +231 -0
  165. data/mlx/mlx/backend/cuda/conv.cpp +403 -0
  166. data/mlx/mlx/backend/cuda/copy/copy.cuh +55 -0
  167. data/mlx/mlx/backend/cuda/copy/copy_contiguous.cu +88 -0
  168. data/mlx/mlx/backend/cuda/copy/copy_general.cu +171 -0
  169. data/mlx/mlx/backend/cuda/copy/copy_general_dynamic.cu +118 -0
  170. data/mlx/mlx/backend/cuda/copy/copy_general_input.cu +229 -0
  171. data/mlx/mlx/backend/cuda/copy.cu +132 -0
  172. data/mlx/mlx/backend/cuda/cublas_utils.cpp +222 -0
  173. data/mlx/mlx/backend/cuda/cublas_utils.h +95 -0
  174. data/mlx/mlx/backend/cuda/cuda.h +21 -0
  175. data/mlx/mlx/backend/cuda/cuda_utils.h +90 -0
  176. data/mlx/mlx/backend/cuda/cudnn_utils.cpp +133 -0
  177. data/mlx/mlx/backend/cuda/cudnn_utils.h +187 -0
  178. data/mlx/mlx/backend/cuda/custom_kernel.cpp +379 -0
  179. data/mlx/mlx/backend/cuda/cutlass_utils.cuh +46 -0
  180. data/mlx/mlx/backend/cuda/delayload.cpp +80 -0
  181. data/mlx/mlx/backend/cuda/device/atomic_ops.cuh +63 -0
  182. data/mlx/mlx/backend/cuda/device/binary_ops.cuh +300 -0
  183. data/mlx/mlx/backend/cuda/device/cast_op.cuh +118 -0
  184. data/mlx/mlx/backend/cuda/device/complex.cuh +60 -0
  185. data/mlx/mlx/backend/cuda/device/config.h +12 -0
  186. data/mlx/mlx/backend/cuda/device/fp16_math.cuh +96 -0
  187. data/mlx/mlx/backend/cuda/device/gather.cuh +53 -0
  188. data/mlx/mlx/backend/cuda/device/gather_axis.cuh +65 -0
  189. data/mlx/mlx/backend/cuda/device/indexing.cuh +30 -0
  190. data/mlx/mlx/backend/cuda/device/scatter.cuh +68 -0
  191. data/mlx/mlx/backend/cuda/device/scatter_axis.cuh +67 -0
  192. data/mlx/mlx/backend/cuda/device/scatter_ops.cuh +44 -0
  193. data/mlx/mlx/backend/cuda/device/ternary_ops.cuh +13 -0
  194. data/mlx/mlx/backend/cuda/device/unary_ops.cuh +350 -0
  195. data/mlx/mlx/backend/cuda/device/utils.cuh +464 -0
  196. data/mlx/mlx/backend/cuda/device.cpp +522 -0
  197. data/mlx/mlx/backend/cuda/device.h +195 -0
  198. data/mlx/mlx/backend/cuda/device_info.cpp +232 -0
  199. data/mlx/mlx/backend/cuda/distributed.cu +121 -0
  200. data/mlx/mlx/backend/cuda/eval.cpp +66 -0
  201. data/mlx/mlx/backend/cuda/event.cu +415 -0
  202. data/mlx/mlx/backend/cuda/event.h +79 -0
  203. data/mlx/mlx/backend/cuda/fence.cpp +42 -0
  204. data/mlx/mlx/backend/cuda/gemms/cublas_gemm.cpp +233 -0
  205. data/mlx/mlx/backend/cuda/gemms/cublas_gemm.h +114 -0
  206. data/mlx/mlx/backend/cuda/gemms/cublas_gemm_batched_12_0.cpp +77 -0
  207. data/mlx/mlx/backend/cuda/gemms/cublas_gemm_batched_12_9.cu +329 -0
  208. data/mlx/mlx/backend/cuda/gemms/gemv.cu +327 -0
  209. data/mlx/mlx/backend/cuda/gemms/gemv.h +34 -0
  210. data/mlx/mlx/backend/cuda/gemms/grouped_gemm.h +25 -0
  211. data/mlx/mlx/backend/cuda/gemms/grouped_gemm_unaligned.cu +358 -0
  212. data/mlx/mlx/backend/cuda/indexing.cpp +434 -0
  213. data/mlx/mlx/backend/cuda/jit_module.cpp +443 -0
  214. data/mlx/mlx/backend/cuda/jit_module.h +120 -0
  215. data/mlx/mlx/backend/cuda/kernel_utils.cu +52 -0
  216. data/mlx/mlx/backend/cuda/kernel_utils.cuh +148 -0
  217. data/mlx/mlx/backend/cuda/layer_norm.cu +417 -0
  218. data/mlx/mlx/backend/cuda/load.cpp +60 -0
  219. data/mlx/mlx/backend/cuda/logsumexp.cu +161 -0
  220. data/mlx/mlx/backend/cuda/lru_cache.h +190 -0
  221. data/mlx/mlx/backend/cuda/matmul.cpp +373 -0
  222. data/mlx/mlx/backend/cuda/no_cuda.cpp +47 -0
  223. data/mlx/mlx/backend/cuda/primitives.cpp +46 -0
  224. data/mlx/mlx/backend/cuda/quantized/affine_quantize.cu +329 -0
  225. data/mlx/mlx/backend/cuda/quantized/convert_fp8.cu +19 -0
  226. data/mlx/mlx/backend/cuda/quantized/cublas_qqmm.cpp +206 -0
  227. data/mlx/mlx/backend/cuda/quantized/cublas_qqmm.h +88 -0
  228. data/mlx/mlx/backend/cuda/quantized/cuda_fp4.h +100 -0
  229. data/mlx/mlx/backend/cuda/quantized/fp_quantize.cu +496 -0
  230. data/mlx/mlx/backend/cuda/quantized/mxfp8_quantize.cuh +32 -0
  231. data/mlx/mlx/backend/cuda/quantized/no_qqmm_impl.cpp +26 -0
  232. data/mlx/mlx/backend/cuda/quantized/nvfp4_quantize.cuh +334 -0
  233. data/mlx/mlx/backend/cuda/quantized/qmv.cu +304 -0
  234. data/mlx/mlx/backend/cuda/quantized/qmv.h +21 -0
  235. data/mlx/mlx/backend/cuda/quantized/qqmm.cpp +158 -0
  236. data/mlx/mlx/backend/cuda/quantized/qqmm_impl.cpp +50 -0
  237. data/mlx/mlx/backend/cuda/quantized/qqmm_impl.h +26 -0
  238. data/mlx/mlx/backend/cuda/quantized/qqmm_utils.cu +227 -0
  239. data/mlx/mlx/backend/cuda/quantized/qqmm_utils.h +30 -0
  240. data/mlx/mlx/backend/cuda/quantized/quantized.cpp +85 -0
  241. data/mlx/mlx/backend/cuda/quantized/quantized.h +53 -0
  242. data/mlx/mlx/backend/cuda/quantized/quantized_utils.cuh +88 -0
  243. data/mlx/mlx/backend/cuda/quantized/quantized_utils.h +50 -0
  244. data/mlx/mlx/backend/cuda/random.cu +202 -0
  245. data/mlx/mlx/backend/cuda/reduce/all_reduce.cu +159 -0
  246. data/mlx/mlx/backend/cuda/reduce/col_reduce.cu +510 -0
  247. data/mlx/mlx/backend/cuda/reduce/init_reduce.cu +50 -0
  248. data/mlx/mlx/backend/cuda/reduce/reduce.cuh +71 -0
  249. data/mlx/mlx/backend/cuda/reduce/reduce_ops.cuh +211 -0
  250. data/mlx/mlx/backend/cuda/reduce/reduce_utils.cuh +145 -0
  251. data/mlx/mlx/backend/cuda/reduce/row_reduce.cu +361 -0
  252. data/mlx/mlx/backend/cuda/reduce.cu +73 -0
  253. data/mlx/mlx/backend/cuda/rms_norm.cu +536 -0
  254. data/mlx/mlx/backend/cuda/rope.cu +429 -0
  255. data/mlx/mlx/backend/cuda/scaled_dot_product_attention.cpp +681 -0
  256. data/mlx/mlx/backend/cuda/scaled_dot_product_attention.cu +796 -0
  257. data/mlx/mlx/backend/cuda/scan.cu +468 -0
  258. data/mlx/mlx/backend/cuda/slicing.cpp +111 -0
  259. data/mlx/mlx/backend/cuda/softmax.cu +162 -0
  260. data/mlx/mlx/backend/cuda/sort.cu +1076 -0
  261. data/mlx/mlx/backend/cuda/steel/defines.cuh +9 -0
  262. data/mlx/mlx/backend/cuda/steel/gemm.cuh +101 -0
  263. data/mlx/mlx/backend/cuda/steel/mma.cuh +117 -0
  264. data/mlx/mlx/backend/cuda/steel/tiles.cuh +450 -0
  265. data/mlx/mlx/backend/cuda/steel/utils.cuh +89 -0
  266. data/mlx/mlx/backend/cuda/ternary.cu +271 -0
  267. data/mlx/mlx/backend/cuda/unary/CMakeLists.txt +34 -0
  268. data/mlx/mlx/backend/cuda/unary/abs.cu +7 -0
  269. data/mlx/mlx/backend/cuda/unary/arccos.cu +7 -0
  270. data/mlx/mlx/backend/cuda/unary/arccosh.cu +7 -0
  271. data/mlx/mlx/backend/cuda/unary/arcsin.cu +7 -0
  272. data/mlx/mlx/backend/cuda/unary/arcsinh.cu +7 -0
  273. data/mlx/mlx/backend/cuda/unary/arctan.cu +7 -0
  274. data/mlx/mlx/backend/cuda/unary/arctanh.cu +7 -0
  275. data/mlx/mlx/backend/cuda/unary/bitwise_invert.cu +7 -0
  276. data/mlx/mlx/backend/cuda/unary/ceil.cu +7 -0
  277. data/mlx/mlx/backend/cuda/unary/conjugate.cu +7 -0
  278. data/mlx/mlx/backend/cuda/unary/cos.cu +7 -0
  279. data/mlx/mlx/backend/cuda/unary/cosh.cu +7 -0
  280. data/mlx/mlx/backend/cuda/unary/erf.cu +7 -0
  281. data/mlx/mlx/backend/cuda/unary/erf_inv.cu +7 -0
  282. data/mlx/mlx/backend/cuda/unary/exp.cu +7 -0
  283. data/mlx/mlx/backend/cuda/unary/expm1.cu +7 -0
  284. data/mlx/mlx/backend/cuda/unary/floor.cu +7 -0
  285. data/mlx/mlx/backend/cuda/unary/imag.cu +7 -0
  286. data/mlx/mlx/backend/cuda/unary/log.cu +21 -0
  287. data/mlx/mlx/backend/cuda/unary/log1p.cu +7 -0
  288. data/mlx/mlx/backend/cuda/unary/logical_not.cu +7 -0
  289. data/mlx/mlx/backend/cuda/unary/negative.cu +7 -0
  290. data/mlx/mlx/backend/cuda/unary/real.cu +7 -0
  291. data/mlx/mlx/backend/cuda/unary/round.cu +18 -0
  292. data/mlx/mlx/backend/cuda/unary/sigmoid.cu +7 -0
  293. data/mlx/mlx/backend/cuda/unary/sign.cu +7 -0
  294. data/mlx/mlx/backend/cuda/unary/sin.cu +7 -0
  295. data/mlx/mlx/backend/cuda/unary/sinh.cu +7 -0
  296. data/mlx/mlx/backend/cuda/unary/sqrt.cu +15 -0
  297. data/mlx/mlx/backend/cuda/unary/square.cu +7 -0
  298. data/mlx/mlx/backend/cuda/unary/tan.cu +7 -0
  299. data/mlx/mlx/backend/cuda/unary/tanh.cu +7 -0
  300. data/mlx/mlx/backend/cuda/unary/unary.cuh +224 -0
  301. data/mlx/mlx/backend/cuda/utils.cpp +116 -0
  302. data/mlx/mlx/backend/cuda/utils.h +49 -0
  303. data/mlx/mlx/backend/cuda/vector_types.cuh +48 -0
  304. data/mlx/mlx/backend/cuda/worker.cpp +79 -0
  305. data/mlx/mlx/backend/cuda/worker.h +55 -0
  306. data/mlx/mlx/backend/gpu/CMakeLists.txt +5 -0
  307. data/mlx/mlx/backend/gpu/copy.cpp +89 -0
  308. data/mlx/mlx/backend/gpu/copy.h +57 -0
  309. data/mlx/mlx/backend/gpu/device_info.h +36 -0
  310. data/mlx/mlx/backend/gpu/eval.h +18 -0
  311. data/mlx/mlx/backend/gpu/primitives.cpp +307 -0
  312. data/mlx/mlx/backend/gpu/slicing.cpp +44 -0
  313. data/mlx/mlx/backend/gpu/slicing.h +36 -0
  314. data/mlx/mlx/backend/metal/CMakeLists.txt +144 -0
  315. data/mlx/mlx/backend/metal/allocator.cpp +279 -0
  316. data/mlx/mlx/backend/metal/allocator.h +79 -0
  317. data/mlx/mlx/backend/metal/binary.cpp +257 -0
  318. data/mlx/mlx/backend/metal/binary.h +33 -0
  319. data/mlx/mlx/backend/metal/compiled.cpp +471 -0
  320. data/mlx/mlx/backend/metal/conv.cpp +1118 -0
  321. data/mlx/mlx/backend/metal/copy.cpp +235 -0
  322. data/mlx/mlx/backend/metal/custom_kernel.cpp +430 -0
  323. data/mlx/mlx/backend/metal/device.cpp +816 -0
  324. data/mlx/mlx/backend/metal/device.h +289 -0
  325. data/mlx/mlx/backend/metal/device_info.cpp +58 -0
  326. data/mlx/mlx/backend/metal/distributed.cpp +38 -0
  327. data/mlx/mlx/backend/metal/eval.cpp +97 -0
  328. data/mlx/mlx/backend/metal/event.cpp +62 -0
  329. data/mlx/mlx/backend/metal/fence.cpp +162 -0
  330. data/mlx/mlx/backend/metal/fft.cpp +807 -0
  331. data/mlx/mlx/backend/metal/hadamard.cpp +198 -0
  332. data/mlx/mlx/backend/metal/indexing.cpp +727 -0
  333. data/mlx/mlx/backend/metal/jit/includes.h +58 -0
  334. data/mlx/mlx/backend/metal/jit/indexing.h +76 -0
  335. data/mlx/mlx/backend/metal/jit_kernels.cpp +1118 -0
  336. data/mlx/mlx/backend/metal/kernels/CMakeLists.txt +193 -0
  337. data/mlx/mlx/backend/metal/kernels/arange.h +9 -0
  338. data/mlx/mlx/backend/metal/kernels/arange.metal +20 -0
  339. data/mlx/mlx/backend/metal/kernels/arg_reduce.metal +182 -0
  340. data/mlx/mlx/backend/metal/kernels/atomic.h +345 -0
  341. data/mlx/mlx/backend/metal/kernels/bf16.h +16 -0
  342. data/mlx/mlx/backend/metal/kernels/bf16_math.h +380 -0
  343. data/mlx/mlx/backend/metal/kernels/binary.h +199 -0
  344. data/mlx/mlx/backend/metal/kernels/binary.metal +109 -0
  345. data/mlx/mlx/backend/metal/kernels/binary_ops.h +330 -0
  346. data/mlx/mlx/backend/metal/kernels/binary_two.h +244 -0
  347. data/mlx/mlx/backend/metal/kernels/binary_two.metal +54 -0
  348. data/mlx/mlx/backend/metal/kernels/cexpf.h +134 -0
  349. data/mlx/mlx/backend/metal/kernels/complex.h +173 -0
  350. data/mlx/mlx/backend/metal/kernels/conv.metal +701 -0
  351. data/mlx/mlx/backend/metal/kernels/copy.h +276 -0
  352. data/mlx/mlx/backend/metal/kernels/copy.metal +75 -0
  353. data/mlx/mlx/backend/metal/kernels/defines.h +24 -0
  354. data/mlx/mlx/backend/metal/kernels/erf.h +69 -0
  355. data/mlx/mlx/backend/metal/kernels/expm1f.h +90 -0
  356. data/mlx/mlx/backend/metal/kernels/fence.metal +52 -0
  357. data/mlx/mlx/backend/metal/kernels/fft/radix.h +328 -0
  358. data/mlx/mlx/backend/metal/kernels/fft/readwrite.h +624 -0
  359. data/mlx/mlx/backend/metal/kernels/fft.h +486 -0
  360. data/mlx/mlx/backend/metal/kernels/fft.metal +67 -0
  361. data/mlx/mlx/backend/metal/kernels/fp4.h +48 -0
  362. data/mlx/mlx/backend/metal/kernels/fp8.h +80 -0
  363. data/mlx/mlx/backend/metal/kernels/fp_quantized.h +1850 -0
  364. data/mlx/mlx/backend/metal/kernels/fp_quantized.metal +153 -0
  365. data/mlx/mlx/backend/metal/kernels/fp_quantized_nax.h +1044 -0
  366. data/mlx/mlx/backend/metal/kernels/fp_quantized_nax.metal +79 -0
  367. data/mlx/mlx/backend/metal/kernels/gemv.metal +868 -0
  368. data/mlx/mlx/backend/metal/kernels/gemv_masked.h +827 -0
  369. data/mlx/mlx/backend/metal/kernels/gemv_masked.metal +76 -0
  370. data/mlx/mlx/backend/metal/kernels/hadamard.h +182 -0
  371. data/mlx/mlx/backend/metal/kernels/indexing/gather.h +51 -0
  372. data/mlx/mlx/backend/metal/kernels/indexing/gather_axis.h +44 -0
  373. data/mlx/mlx/backend/metal/kernels/indexing/gather_front.h +24 -0
  374. data/mlx/mlx/backend/metal/kernels/indexing/indexing.h +23 -0
  375. data/mlx/mlx/backend/metal/kernels/indexing/masked_scatter.h +41 -0
  376. data/mlx/mlx/backend/metal/kernels/indexing/scatter.h +59 -0
  377. data/mlx/mlx/backend/metal/kernels/indexing/scatter_axis.h +52 -0
  378. data/mlx/mlx/backend/metal/kernels/layer_norm.metal +433 -0
  379. data/mlx/mlx/backend/metal/kernels/logging.h +26 -0
  380. data/mlx/mlx/backend/metal/kernels/logsumexp.h +140 -0
  381. data/mlx/mlx/backend/metal/kernels/logsumexp.metal +18 -0
  382. data/mlx/mlx/backend/metal/kernels/quantized.h +2508 -0
  383. data/mlx/mlx/backend/metal/kernels/quantized.metal +144 -0
  384. data/mlx/mlx/backend/metal/kernels/quantized_nax.h +1705 -0
  385. data/mlx/mlx/backend/metal/kernels/quantized_nax.metal +106 -0
  386. data/mlx/mlx/backend/metal/kernels/quantized_utils.h +90 -0
  387. data/mlx/mlx/backend/metal/kernels/random.metal +103 -0
  388. data/mlx/mlx/backend/metal/kernels/reduce.h +5 -0
  389. data/mlx/mlx/backend/metal/kernels/reduce.metal +169 -0
  390. data/mlx/mlx/backend/metal/kernels/reduce_utils.h +6 -0
  391. data/mlx/mlx/backend/metal/kernels/reduction/ops.h +275 -0
  392. data/mlx/mlx/backend/metal/kernels/reduction/reduce_all.h +66 -0
  393. data/mlx/mlx/backend/metal/kernels/reduction/reduce_col.h +398 -0
  394. data/mlx/mlx/backend/metal/kernels/reduction/reduce_init.h +8 -0
  395. data/mlx/mlx/backend/metal/kernels/reduction/reduce_row.h +369 -0
  396. data/mlx/mlx/backend/metal/kernels/rms_norm.metal +391 -0
  397. data/mlx/mlx/backend/metal/kernels/rope.metal +229 -0
  398. data/mlx/mlx/backend/metal/kernels/scaled_dot_product_attention.metal +44 -0
  399. data/mlx/mlx/backend/metal/kernels/scan.h +514 -0
  400. data/mlx/mlx/backend/metal/kernels/scan.metal +109 -0
  401. data/mlx/mlx/backend/metal/kernels/sdpa_vector.h +394 -0
  402. data/mlx/mlx/backend/metal/kernels/softmax.h +190 -0
  403. data/mlx/mlx/backend/metal/kernels/softmax.metal +24 -0
  404. data/mlx/mlx/backend/metal/kernels/sort.h +719 -0
  405. data/mlx/mlx/backend/metal/kernels/sort.metal +80 -0
  406. data/mlx/mlx/backend/metal/kernels/steel/attn/attn.h +296 -0
  407. data/mlx/mlx/backend/metal/kernels/steel/attn/kernels/steel_attention.h +471 -0
  408. data/mlx/mlx/backend/metal/kernels/steel/attn/kernels/steel_attention.metal +27 -0
  409. data/mlx/mlx/backend/metal/kernels/steel/attn/kernels/steel_attention_nax.h +481 -0
  410. data/mlx/mlx/backend/metal/kernels/steel/attn/kernels/steel_attention_nax.metal +28 -0
  411. data/mlx/mlx/backend/metal/kernels/steel/attn/loader.h +264 -0
  412. data/mlx/mlx/backend/metal/kernels/steel/attn/mma.h +750 -0
  413. data/mlx/mlx/backend/metal/kernels/steel/attn/nax.h +1076 -0
  414. data/mlx/mlx/backend/metal/kernels/steel/attn/params.h +44 -0
  415. data/mlx/mlx/backend/metal/kernels/steel/attn/transforms.h +71 -0
  416. data/mlx/mlx/backend/metal/kernels/steel/conv/conv.h +13 -0
  417. data/mlx/mlx/backend/metal/kernels/steel/conv/kernels/steel_conv.h +176 -0
  418. data/mlx/mlx/backend/metal/kernels/steel/conv/kernels/steel_conv.metal +56 -0
  419. data/mlx/mlx/backend/metal/kernels/steel/conv/kernels/steel_conv_general.h +225 -0
  420. data/mlx/mlx/backend/metal/kernels/steel/conv/kernels/steel_conv_general.metal +47 -0
  421. data/mlx/mlx/backend/metal/kernels/steel/conv/loader.h +6 -0
  422. data/mlx/mlx/backend/metal/kernels/steel/conv/loaders/loader_channel_l.h +451 -0
  423. data/mlx/mlx/backend/metal/kernels/steel/conv/loaders/loader_channel_n.h +319 -0
  424. data/mlx/mlx/backend/metal/kernels/steel/conv/loaders/loader_general.h +381 -0
  425. data/mlx/mlx/backend/metal/kernels/steel/conv/params.h +62 -0
  426. data/mlx/mlx/backend/metal/kernels/steel/defines.h +7 -0
  427. data/mlx/mlx/backend/metal/kernels/steel/gemm/gemm.h +295 -0
  428. data/mlx/mlx/backend/metal/kernels/steel/gemm/gemm_nax.h +157 -0
  429. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_fused.h +346 -0
  430. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_fused.metal +34 -0
  431. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_fused_nax.h +219 -0
  432. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_fused_nax.metal +30 -0
  433. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_gather.h +459 -0
  434. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_gather.metal +59 -0
  435. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_gather_nax.h +143 -0
  436. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_gather_nax.metal +37 -0
  437. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_masked.h +719 -0
  438. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_masked.metal +76 -0
  439. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_segmented.h +266 -0
  440. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_segmented.metal +43 -0
  441. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_splitk.h +227 -0
  442. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_splitk.metal +76 -0
  443. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_splitk_nax.h +152 -0
  444. data/mlx/mlx/backend/metal/kernels/steel/gemm/kernels/steel_gemm_splitk_nax.metal +30 -0
  445. data/mlx/mlx/backend/metal/kernels/steel/gemm/loader.h +137 -0
  446. data/mlx/mlx/backend/metal/kernels/steel/gemm/mma.h +1146 -0
  447. data/mlx/mlx/backend/metal/kernels/steel/gemm/nax.h +1084 -0
  448. data/mlx/mlx/backend/metal/kernels/steel/gemm/params.h +65 -0
  449. data/mlx/mlx/backend/metal/kernels/steel/gemm/transforms.h +72 -0
  450. data/mlx/mlx/backend/metal/kernels/steel/utils/integral_constant.h +134 -0
  451. data/mlx/mlx/backend/metal/kernels/steel/utils/type_traits.h +55 -0
  452. data/mlx/mlx/backend/metal/kernels/steel/utils.h +42 -0
  453. data/mlx/mlx/backend/metal/kernels/ternary.h +145 -0
  454. data/mlx/mlx/backend/metal/kernels/ternary.metal +48 -0
  455. data/mlx/mlx/backend/metal/kernels/ternary_ops.h +10 -0
  456. data/mlx/mlx/backend/metal/kernels/unary.h +63 -0
  457. data/mlx/mlx/backend/metal/kernels/unary.metal +115 -0
  458. data/mlx/mlx/backend/metal/kernels/unary_ops.h +454 -0
  459. data/mlx/mlx/backend/metal/kernels/utils.h +445 -0
  460. data/mlx/mlx/backend/metal/kernels.h +375 -0
  461. data/mlx/mlx/backend/metal/logsumexp.cpp +95 -0
  462. data/mlx/mlx/backend/metal/make_compiled_preamble.sh +120 -0
  463. data/mlx/mlx/backend/metal/matmul.cpp +2572 -0
  464. data/mlx/mlx/backend/metal/matmul.h +144 -0
  465. data/mlx/mlx/backend/metal/metal.cpp +50 -0
  466. data/mlx/mlx/backend/metal/metal.h +25 -0
  467. data/mlx/mlx/backend/metal/no_metal.cpp +42 -0
  468. data/mlx/mlx/backend/metal/nojit_kernels.cpp +414 -0
  469. data/mlx/mlx/backend/metal/normalization.cpp +433 -0
  470. data/mlx/mlx/backend/metal/primitives.cpp +242 -0
  471. data/mlx/mlx/backend/metal/quantized.cpp +1651 -0
  472. data/mlx/mlx/backend/metal/reduce.cpp +1038 -0
  473. data/mlx/mlx/backend/metal/reduce.h +41 -0
  474. data/mlx/mlx/backend/metal/resident.cpp +100 -0
  475. data/mlx/mlx/backend/metal/resident.h +32 -0
  476. data/mlx/mlx/backend/metal/rope.cpp +165 -0
  477. data/mlx/mlx/backend/metal/scaled_dot_product_attention.cpp +798 -0
  478. data/mlx/mlx/backend/metal/scan.cpp +145 -0
  479. data/mlx/mlx/backend/metal/scan.h +17 -0
  480. data/mlx/mlx/backend/metal/slicing.cpp +99 -0
  481. data/mlx/mlx/backend/metal/softmax.cpp +87 -0
  482. data/mlx/mlx/backend/metal/sort.cpp +368 -0
  483. data/mlx/mlx/backend/metal/ternary.cpp +160 -0
  484. data/mlx/mlx/backend/metal/ternary.h +21 -0
  485. data/mlx/mlx/backend/metal/unary.cpp +161 -0
  486. data/mlx/mlx/backend/metal/unary.h +21 -0
  487. data/mlx/mlx/backend/metal/utils.cpp +77 -0
  488. data/mlx/mlx/backend/metal/utils.h +99 -0
  489. data/mlx/mlx/backend/no_cpu/CMakeLists.txt +7 -0
  490. data/mlx/mlx/backend/no_cpu/compiled.cpp +24 -0
  491. data/mlx/mlx/backend/no_cpu/device_info.cpp +22 -0
  492. data/mlx/mlx/backend/no_cpu/primitives.cpp +146 -0
  493. data/mlx/mlx/backend/no_gpu/CMakeLists.txt +8 -0
  494. data/mlx/mlx/backend/no_gpu/allocator.cpp +134 -0
  495. data/mlx/mlx/backend/no_gpu/apple_memory.h +16 -0
  496. data/mlx/mlx/backend/no_gpu/device_info.cpp +22 -0
  497. data/mlx/mlx/backend/no_gpu/eval.cpp +24 -0
  498. data/mlx/mlx/backend/no_gpu/event.cpp +53 -0
  499. data/mlx/mlx/backend/no_gpu/fence.cpp +54 -0
  500. data/mlx/mlx/backend/no_gpu/linux_memory.h +22 -0
  501. data/mlx/mlx/backend/no_gpu/primitives.cpp +185 -0
  502. data/mlx/mlx/compile.cpp +1243 -0
  503. data/mlx/mlx/compile.h +45 -0
  504. data/mlx/mlx/compile_impl.h +70 -0
  505. data/mlx/mlx/device.cpp +72 -0
  506. data/mlx/mlx/device.h +56 -0
  507. data/mlx/mlx/distributed/CMakeLists.txt +14 -0
  508. data/mlx/mlx/distributed/distributed.cpp +197 -0
  509. data/mlx/mlx/distributed/distributed.h +61 -0
  510. data/mlx/mlx/distributed/distributed_impl.h +59 -0
  511. data/mlx/mlx/distributed/jaccl/CMakeLists.txt +12 -0
  512. data/mlx/mlx/distributed/jaccl/jaccl.cpp +178 -0
  513. data/mlx/mlx/distributed/jaccl/jaccl.h +12 -0
  514. data/mlx/mlx/distributed/jaccl/mesh.cpp +451 -0
  515. data/mlx/mlx/distributed/jaccl/mesh.h +122 -0
  516. data/mlx/mlx/distributed/jaccl/no_jaccl.cpp +20 -0
  517. data/mlx/mlx/distributed/jaccl/ring.cpp +692 -0
  518. data/mlx/mlx/distributed/jaccl/ring.h +178 -0
  519. data/mlx/mlx/distributed/jaccl/utils.cpp +329 -0
  520. data/mlx/mlx/distributed/jaccl/utils.h +342 -0
  521. data/mlx/mlx/distributed/mpi/CMakeLists.txt +5 -0
  522. data/mlx/mlx/distributed/mpi/mpi.cpp +501 -0
  523. data/mlx/mlx/distributed/mpi/mpi.h +12 -0
  524. data/mlx/mlx/distributed/mpi/mpi_declarations.h +28 -0
  525. data/mlx/mlx/distributed/mpi/no_mpi.cpp +20 -0
  526. data/mlx/mlx/distributed/nccl/CMakeLists.txt +26 -0
  527. data/mlx/mlx/distributed/nccl/nccl.cpp +443 -0
  528. data/mlx/mlx/distributed/nccl/nccl.h +12 -0
  529. data/mlx/mlx/distributed/nccl/nccl_stub/CMakeLists.txt +1 -0
  530. data/mlx/mlx/distributed/nccl/nccl_stub/nccl_stubs.cpp +54 -0
  531. data/mlx/mlx/distributed/nccl/no_nccl.cpp +20 -0
  532. data/mlx/mlx/distributed/ops.cpp +186 -0
  533. data/mlx/mlx/distributed/ops.h +57 -0
  534. data/mlx/mlx/distributed/primitives.cpp +95 -0
  535. data/mlx/mlx/distributed/primitives.h +156 -0
  536. data/mlx/mlx/distributed/reduction_ops.h +38 -0
  537. data/mlx/mlx/distributed/ring/CMakeLists.txt +5 -0
  538. data/mlx/mlx/distributed/ring/no_ring.cpp +20 -0
  539. data/mlx/mlx/distributed/ring/ring.cpp +870 -0
  540. data/mlx/mlx/distributed/ring/ring.h +12 -0
  541. data/mlx/mlx/distributed/utils.cpp +206 -0
  542. data/mlx/mlx/distributed/utils.h +67 -0
  543. data/mlx/mlx/dtype.cpp +197 -0
  544. data/mlx/mlx/dtype.h +116 -0
  545. data/mlx/mlx/dtype_utils.cpp +42 -0
  546. data/mlx/mlx/dtype_utils.h +119 -0
  547. data/mlx/mlx/einsum.cpp +941 -0
  548. data/mlx/mlx/einsum.h +23 -0
  549. data/mlx/mlx/event.h +58 -0
  550. data/mlx/mlx/export.cpp +1130 -0
  551. data/mlx/mlx/export.h +137 -0
  552. data/mlx/mlx/export_impl.h +99 -0
  553. data/mlx/mlx/fast.cpp +941 -0
  554. data/mlx/mlx/fast.h +103 -0
  555. data/mlx/mlx/fast_primitives.h +427 -0
  556. data/mlx/mlx/fence.h +39 -0
  557. data/mlx/mlx/fft.cpp +262 -0
  558. data/mlx/mlx/fft.h +159 -0
  559. data/mlx/mlx/graph_utils.cpp +175 -0
  560. data/mlx/mlx/graph_utils.h +67 -0
  561. data/mlx/mlx/io/CMakeLists.txt +25 -0
  562. data/mlx/mlx/io/gguf.cpp +470 -0
  563. data/mlx/mlx/io/gguf.h +20 -0
  564. data/mlx/mlx/io/gguf_quants.cpp +164 -0
  565. data/mlx/mlx/io/load.cpp +397 -0
  566. data/mlx/mlx/io/load.h +175 -0
  567. data/mlx/mlx/io/no_gguf.cpp +20 -0
  568. data/mlx/mlx/io/no_safetensors.cpp +37 -0
  569. data/mlx/mlx/io/safetensors.cpp +234 -0
  570. data/mlx/mlx/io.h +61 -0
  571. data/mlx/mlx/linalg.cpp +708 -0
  572. data/mlx/mlx/linalg.h +115 -0
  573. data/mlx/mlx/memory.h +80 -0
  574. data/mlx/mlx/mlx.h +25 -0
  575. data/mlx/mlx/ops.cpp +6094 -0
  576. data/mlx/mlx/ops.h +1610 -0
  577. data/mlx/mlx/primitives.cpp +5850 -0
  578. data/mlx/mlx/primitives.h +2525 -0
  579. data/mlx/mlx/random.cpp +492 -0
  580. data/mlx/mlx/random.h +283 -0
  581. data/mlx/mlx/scheduler.cpp +73 -0
  582. data/mlx/mlx/scheduler.h +189 -0
  583. data/mlx/mlx/small_vector.h +540 -0
  584. data/mlx/mlx/stream.h +42 -0
  585. data/mlx/mlx/threadpool.h +133 -0
  586. data/mlx/mlx/transforms.cpp +1065 -0
  587. data/mlx/mlx/transforms.h +231 -0
  588. data/mlx/mlx/transforms_impl.h +88 -0
  589. data/mlx/mlx/types/bf16.h +187 -0
  590. data/mlx/mlx/types/complex.h +113 -0
  591. data/mlx/mlx/types/fp16.h +234 -0
  592. data/mlx/mlx/types/half_types.h +58 -0
  593. data/mlx/mlx/types/limits.h +70 -0
  594. data/mlx/mlx/utils.cpp +302 -0
  595. data/mlx/mlx/utils.h +174 -0
  596. data/mlx/mlx/version.cpp +11 -0
  597. data/mlx/mlx/version.h +22 -0
  598. data/mlx/mlx.pc.in +52 -0
  599. metadata +643 -0
@@ -0,0 +1,289 @@
1
+ // Copyright © 2023-2024 Apple Inc.
2
+
3
+ #pragma once
4
+
5
+ #include <Metal/Metal.hpp>
6
+ #include <functional>
7
+ #include <mutex>
8
+ #include <shared_mutex>
9
+ #include <string>
10
+ #include <unordered_map>
11
+ #include <unordered_set>
12
+
13
+ #include "mlx/array.h"
14
+ #include "mlx/device.h"
15
+
16
+ namespace mlx::core::metal {
17
+
18
+ using MTLFCList =
19
+ std::vector<std::tuple<const void*, MTL::DataType, NS::UInteger>>;
20
+
21
+ struct DeviceStream;
22
+
23
+ struct MLX_API CommandEncoder {
24
+ explicit CommandEncoder(DeviceStream& stream);
25
+ CommandEncoder(const CommandEncoder&) = delete;
26
+ CommandEncoder& operator=(const CommandEncoder&) = delete;
27
+
28
+ struct ConcurrentContext {
29
+ ConcurrentContext(CommandEncoder& enc) : enc(enc) {
30
+ enc.concurrent_ = true;
31
+ }
32
+ ~ConcurrentContext() {
33
+ enc.concurrent_ = false;
34
+ enc.prev_outputs_.insert(
35
+ enc.concurrent_outputs_.begin(), enc.concurrent_outputs_.end());
36
+ enc.concurrent_outputs_.clear();
37
+ }
38
+
39
+ private:
40
+ CommandEncoder& enc;
41
+ };
42
+
43
+ void set_input_array(const array& a, int idx, int64_t offset = 0);
44
+ void set_output_array(array& a, int idx, int64_t offset = 0);
45
+ void register_output_array(const array& a);
46
+ void dispatch_threadgroups(MTL::Size grid_dims, MTL::Size group_dims);
47
+ void dispatch_threads(MTL::Size grid_dims, MTL::Size group_dims);
48
+ void maybeInsertBarrier();
49
+ void set_buffer(const MTL::Buffer* buf, int idx, int64_t offset = 0);
50
+
51
+ void set_compute_pipeline_state(MTL::ComputePipelineState* kernel) {
52
+ enc_->setComputePipelineState(kernel);
53
+ }
54
+
55
+ void wait_for_fence(MTL::Fence* fence) {
56
+ enc_->waitForFence(fence);
57
+ }
58
+
59
+ void update_fence(MTL::Fence* fence) {
60
+ enc_->updateFence(fence);
61
+ }
62
+
63
+ template <typename Vec, typename = std::enable_if_t<is_vector_v<Vec>>>
64
+ void set_vector_bytes(const Vec& vec, size_t nelems, int idx) {
65
+ enc_->setBytes(vec.data(), nelems * sizeof(typename Vec::value_type), idx);
66
+ }
67
+ template <typename Vec, typename = std::enable_if_t<is_vector_v<Vec>>>
68
+ void set_vector_bytes(const Vec& vec, int idx) {
69
+ return set_vector_bytes(vec, vec.size(), idx);
70
+ }
71
+
72
+ template <typename T>
73
+ void set_bytes(const T* v, int n, int idx) {
74
+ return enc_->setBytes(v, n * sizeof(T), idx);
75
+ }
76
+
77
+ template <typename T>
78
+ void set_bytes(const T& v, int idx) {
79
+ return enc_->setBytes(&v, sizeof(T), idx);
80
+ }
81
+
82
+ void set_threadgroup_memory_length(size_t length, int idx) {
83
+ enc_->setThreadgroupMemoryLength(length, idx);
84
+ }
85
+
86
+ ConcurrentContext start_concurrent() {
87
+ return ConcurrentContext(*this);
88
+ }
89
+ ~CommandEncoder();
90
+
91
+ // Inputs to all kernels in the encoder including temporaries
92
+ std::unordered_set<const void*>& inputs() {
93
+ return all_inputs_;
94
+ };
95
+
96
+ // Outputs of all kernels in the encoder including temporaries
97
+ std::unordered_set<const void*>& outputs() {
98
+ return all_outputs_;
99
+ };
100
+
101
+ void barrier();
102
+
103
+ private:
104
+ DeviceStream& stream_;
105
+ MTL::ComputeCommandEncoder* enc_;
106
+ bool needs_barrier_{false};
107
+ bool concurrent_{false};
108
+ std::unordered_set<MTL::Resource*> prev_outputs_;
109
+ std::unordered_set<MTL::Resource*> next_outputs_;
110
+ std::unordered_set<MTL::Resource*> concurrent_outputs_;
111
+ std::unordered_set<const void*> all_inputs_;
112
+ std::unordered_set<const void*> all_outputs_;
113
+ };
114
+
115
+ struct Fence {
116
+ Fence(MTL::Fence* fence) : fence(fence) {}
117
+ ~Fence() {
118
+ fence->release();
119
+ }
120
+ MTL::Fence* fence;
121
+ };
122
+
123
+ struct DeviceStream {
124
+ DeviceStream(MTL::CommandQueue* queue) : queue(queue) {};
125
+ ~DeviceStream() {
126
+ queue->release();
127
+ if (buffer != nullptr) {
128
+ buffer->release();
129
+ }
130
+ };
131
+ MTL::CommandQueue* queue;
132
+ // A map of prior command encoder outputs to their corresponding fence
133
+ std::unordered_map<const void*, std::shared_ptr<Fence>> outputs;
134
+ // Used to allow thread-safe access to the outputs map
135
+ std::mutex fence_mtx;
136
+
137
+ // Data updated between command buffers
138
+ MTL::CommandBuffer* buffer{nullptr};
139
+ int buffer_ops{0};
140
+ size_t buffer_sizes{0};
141
+
142
+ // The command encoder, fence, and temporaries are updated between command
143
+ // encoders
144
+ std::unique_ptr<CommandEncoder> encoder{nullptr};
145
+ std::shared_ptr<Fence> fence;
146
+ std::vector<array> temporaries;
147
+ };
148
+
149
+ class MLX_API Device {
150
+ public:
151
+ Device();
152
+ Device(const Device&) = delete;
153
+ Device& operator=(const Device&) = delete;
154
+ ~Device();
155
+
156
+ MTL::Device* mtl_device() {
157
+ return device_;
158
+ };
159
+
160
+ const std::string& get_architecture() {
161
+ return arch_;
162
+ }
163
+
164
+ int get_architecture_gen() const {
165
+ return arch_gen_;
166
+ }
167
+
168
+ void new_queue(int index);
169
+
170
+ MTL::CommandQueue* get_queue(Stream stream);
171
+
172
+ MTL::CommandBuffer* get_command_buffer(int index);
173
+ bool command_buffer_needs_commit(int index);
174
+ void commit_command_buffer(int index);
175
+ CommandEncoder& get_command_encoder(int index);
176
+ void end_encoding(int index);
177
+
178
+ MTL::Library* get_library(
179
+ const std::string& name,
180
+ const std::string& path = "");
181
+
182
+ MTL::Library* get_library(
183
+ const std::string& name,
184
+ const std::function<std::string(void)>& builder);
185
+
186
+ void clear_library(const std::string& name);
187
+
188
+ MTL::ComputePipelineState* get_kernel(
189
+ const std::string& base_name,
190
+ MTL::Library* mtl_lib,
191
+ const std::string& hash_name = "",
192
+ const MTLFCList& func_consts = {},
193
+ const std::vector<MTL::Function*>& linked_functions = {});
194
+
195
+ MTL::ComputePipelineState* get_kernel(
196
+ const std::string& base_name,
197
+ const std::string& hash_name = "",
198
+ const MTLFCList& func_consts = {},
199
+ const std::vector<MTL::Function*>& linked_functions = {});
200
+
201
+ MTL::ArgumentEncoder* argument_encoder(
202
+ const std::vector<MTL::ArgumentDescriptor*>& arg_descs) const;
203
+
204
+ // Record temporary arrays for the given stream index
205
+ void add_temporary(array arr, int index);
206
+ void add_temporaries(std::vector<array> arrays, int index);
207
+
208
+ void set_residency_set(const MTL::ResidencySet* residency_set);
209
+
210
+ private:
211
+ DeviceStream& get_stream_(int index) {
212
+ return stream_map_.find(index)->second;
213
+ }
214
+ MTL::Library* get_library_cache_(const std::string& name);
215
+
216
+ MTL::Library* get_library_(const std::string& name);
217
+ MTL::Library* build_library_(const std::string& source_string);
218
+
219
+ MTL::Function* get_function_(const std::string& name, MTL::Library* mtl_lib);
220
+
221
+ MTL::Function* get_function_(
222
+ const std::string& name,
223
+ const std::string& specialized_name,
224
+ const MTLFCList& func_consts,
225
+ MTL::Library* mtl_lib);
226
+
227
+ MTL::LinkedFunctions* get_linked_functions_(
228
+ const std::vector<MTL::Function*>& funcs);
229
+
230
+ MTL::ComputePipelineState* get_kernel_(
231
+ const std::string& name,
232
+ const MTL::Function* mtl_function);
233
+
234
+ MTL::ComputePipelineState* get_kernel_(
235
+ const std::string& name,
236
+ const MTL::Function* mtl_function,
237
+ const MTL::LinkedFunctions* linked_functions);
238
+
239
+ MTL::ComputePipelineState* get_kernel_(
240
+ const std::string& base_name,
241
+ MTL::Library* mtl_lib,
242
+ const std::string& hash_name,
243
+ const MTLFCList& func_consts = {},
244
+ const std::vector<MTL::Function*>& linked_functions = {});
245
+
246
+ MTL::Device* device_;
247
+ std::unordered_map<int32_t, DeviceStream> stream_map_;
248
+
249
+ std::shared_mutex kernel_mtx_;
250
+ std::shared_mutex library_mtx_;
251
+ std::unordered_map<std::string, MTL::Library*> library_map_;
252
+ MTL::Library* default_library_;
253
+ std::unordered_map<
254
+ MTL::Library*,
255
+ std::unordered_map<std::string, MTL::ComputePipelineState*>>
256
+ library_kernels_;
257
+ const MTL::ResidencySet* residency_set_{nullptr};
258
+ std::string arch_;
259
+ int arch_gen_;
260
+ int max_ops_per_buffer_;
261
+ int max_mb_per_buffer_;
262
+ };
263
+
264
+ MLX_API Device& device(mlx::core::Device);
265
+
266
+ std::unique_ptr<void, std::function<void(void*)>> new_scoped_memory_pool();
267
+
268
+ inline bool is_nax_available() {
269
+ #ifdef MLX_METAL_NO_NAX
270
+ return false;
271
+ #else
272
+ auto _check_nax = []() {
273
+ bool can_use_nax = false;
274
+ if (__builtin_available(
275
+ macOS 26.2, iOS 26.2, tvOS 26.2, visionOS 26.2, *)) {
276
+ can_use_nax = true;
277
+ }
278
+ auto& d = metal::device(mlx::core::Device::gpu);
279
+ auto arch = d.get_architecture().back();
280
+ auto gen = d.get_architecture_gen();
281
+ can_use_nax &= gen >= (arch == 'p' ? 18 : 17);
282
+ return can_use_nax;
283
+ };
284
+ static bool is_nax_available_ = _check_nax();
285
+ return is_nax_available_;
286
+ #endif
287
+ }
288
+
289
+ } // namespace mlx::core::metal
@@ -0,0 +1,58 @@
1
+ // Copyright © 2026 Apple Inc.
2
+
3
+ #include <sys/sysctl.h>
4
+
5
+ #include "mlx/backend/gpu/device_info.h"
6
+ #include "mlx/backend/metal/device.h"
7
+ #include "mlx/backend/metal/metal.h"
8
+
9
+ namespace mlx::core::gpu {
10
+
11
+ bool is_available() {
12
+ return metal::is_available();
13
+ }
14
+
15
+ int device_count() {
16
+ return 1;
17
+ }
18
+
19
+ const std::unordered_map<std::string, std::variant<std::string, size_t>>&
20
+ device_info(int device_index) {
21
+ auto init_device_info = []()
22
+ -> std::unordered_map<std::string, std::variant<std::string, size_t>> {
23
+ auto pool = metal::new_scoped_memory_pool();
24
+ auto raw_device = metal::device(mlx::core::Device::gpu).mtl_device();
25
+ auto name = std::string(raw_device->name()->utf8String());
26
+ auto arch = std::string(raw_device->architecture()->name()->utf8String());
27
+
28
+ size_t memsize = 0;
29
+ size_t length = sizeof(memsize);
30
+ sysctlbyname("hw.memsize", &memsize, &length, NULL, 0);
31
+
32
+ size_t rsrc_limit = 0;
33
+ sysctlbyname("iogpu.rsrc_limit", &rsrc_limit, &length, NULL, 0);
34
+ if (rsrc_limit == 0) {
35
+ rsrc_limit = 499000;
36
+ }
37
+
38
+ return {
39
+ {"device_name", name},
40
+ {"architecture", arch},
41
+ {"max_buffer_length", raw_device->maxBufferLength()},
42
+ {"max_recommended_working_set_size",
43
+ raw_device->recommendedMaxWorkingSetSize()},
44
+ {"memory_size", memsize},
45
+ {"resource_limit", rsrc_limit}};
46
+ };
47
+ static auto device_info_ = init_device_info();
48
+ static std::unordered_map<std::string, std::variant<std::string, size_t>>
49
+ empty;
50
+
51
+ if (device_index == 0) {
52
+ return device_info_;
53
+ } else {
54
+ return empty;
55
+ }
56
+ }
57
+
58
+ } // namespace mlx::core::gpu
@@ -0,0 +1,38 @@
1
+ // Copyright © 2024 Apple Inc.
2
+
3
+ #include <cassert>
4
+
5
+ #include "mlx/allocator.h"
6
+ #include "mlx/backend/common/utils.h"
7
+ #include "mlx/backend/gpu/copy.h"
8
+ #include "mlx/backend/metal/device.h"
9
+ #include "mlx/backend/metal/utils.h"
10
+ #include "mlx/distributed/ops.h"
11
+ #include "mlx/distributed/primitives.h"
12
+ #include "mlx/fence.h"
13
+ #include "mlx/scheduler.h"
14
+
15
+ namespace mlx::core::distributed {
16
+
17
+ void AllReduce::eval_gpu(const std::vector<array>&, std::vector<array>&) {
18
+ throw std::runtime_error("[AllReduce::eval_gpu] has no GPU implementation.");
19
+ }
20
+
21
+ void AllGather::eval_gpu(const std::vector<array>&, std::vector<array>&) {
22
+ throw std::runtime_error("[AllGather::eval_gpu] has no GPU implementation.");
23
+ }
24
+
25
+ void Send::eval_gpu(const std::vector<array>&, std::vector<array>&) {
26
+ throw std::runtime_error("[Send::eval_gpu] has no GPU implementation.");
27
+ }
28
+
29
+ void Recv::eval_gpu(const std::vector<array>&, std::vector<array>&) {
30
+ throw std::runtime_error("[Recv::eval_gpu] has no GPU implementation.");
31
+ }
32
+
33
+ void ReduceScatter::eval_gpu(const std::vector<array>&, std::vector<array>&) {
34
+ throw std::runtime_error(
35
+ "[ReduceScatter::eval_gpu] has no GPU implementation.");
36
+ }
37
+
38
+ } // namespace mlx::core::distributed
@@ -0,0 +1,97 @@
1
+ // Copyright © 2023-2024 Apple Inc.
2
+ #include <memory>
3
+
4
+ #include "mlx/backend/gpu/eval.h"
5
+ #include "mlx/backend/metal/device.h"
6
+ #include "mlx/backend/metal/utils.h"
7
+ #include "mlx/primitives.h"
8
+ #include "mlx/scheduler.h"
9
+
10
+ namespace mlx::core::gpu {
11
+
12
+ void new_stream(Stream stream) {
13
+ if (stream.device == mlx::core::Device::gpu) {
14
+ metal::device(stream.device).new_queue(stream.index);
15
+ }
16
+ }
17
+
18
+ inline void check_error(MTL::CommandBuffer* cbuf) {
19
+ if (cbuf->status() == MTL::CommandBufferStatusError) {
20
+ std::ostringstream msg;
21
+ msg << "[METAL] Command buffer execution failed: "
22
+ << cbuf->error()->localizedDescription()->utf8String();
23
+ throw std::runtime_error(msg.str());
24
+ }
25
+ }
26
+
27
+ void eval(array& arr) {
28
+ auto pool = metal::new_scoped_memory_pool();
29
+ auto s = arr.primitive().stream();
30
+ auto& d = metal::device(s.device);
31
+ auto command_buffer = d.get_command_buffer(s.index);
32
+
33
+ auto outputs = arr.outputs();
34
+ {
35
+ // If the array is a tracer hold a reference
36
+ // to its inputs so they don't get donated
37
+ std::vector<array> inputs;
38
+ if (arr.is_tracer()) {
39
+ inputs = arr.inputs();
40
+ }
41
+
42
+ debug_set_primitive_buffer_label(command_buffer, arr.primitive());
43
+ arr.primitive().eval_gpu(arr.inputs(), outputs);
44
+ }
45
+ std::unordered_set<std::shared_ptr<array::Data>> buffers;
46
+ for (auto& in : arr.inputs()) {
47
+ buffers.insert(in.data_shared_ptr());
48
+ }
49
+ for (auto& s : arr.siblings()) {
50
+ buffers.insert(s.data_shared_ptr());
51
+ }
52
+ // Remove the output if it was donated to by an input
53
+ if (auto it = buffers.find(arr.data_shared_ptr()); it != buffers.end()) {
54
+ buffers.erase(it);
55
+ }
56
+
57
+ if (d.command_buffer_needs_commit(s.index)) {
58
+ d.end_encoding(s.index);
59
+ scheduler::notify_new_task(s);
60
+ command_buffer->addCompletedHandler(
61
+ [s, buffers = std::move(buffers)](MTL::CommandBuffer* cbuf) {
62
+ scheduler::notify_task_completion(s);
63
+ check_error(cbuf);
64
+ });
65
+ d.commit_command_buffer(s.index);
66
+ d.get_command_buffer(s.index);
67
+ } else {
68
+ command_buffer->addCompletedHandler(
69
+ [buffers = std::move(buffers)](MTL::CommandBuffer* cbuf) {
70
+ check_error(cbuf);
71
+ });
72
+ }
73
+ }
74
+
75
+ void finalize(Stream s) {
76
+ auto pool = metal::new_scoped_memory_pool();
77
+ auto& d = metal::device(s.device);
78
+ auto cb = d.get_command_buffer(s.index);
79
+ d.end_encoding(s.index);
80
+ cb->addCompletedHandler([](MTL::CommandBuffer* cbuf) { check_error(cbuf); });
81
+ d.commit_command_buffer(s.index);
82
+ d.get_command_buffer(s.index);
83
+ }
84
+
85
+ void synchronize(Stream s) {
86
+ auto pool = metal::new_scoped_memory_pool();
87
+ auto& d = metal::device(s.device);
88
+ auto cb = d.get_command_buffer(s.index);
89
+ cb->retain();
90
+ d.end_encoding(s.index);
91
+ d.commit_command_buffer(s.index);
92
+ cb->waitUntilCompleted();
93
+ check_error(cb);
94
+ cb->release();
95
+ }
96
+
97
+ } // namespace mlx::core::gpu
@@ -0,0 +1,62 @@
1
+ // Copyright © 2024 Apple Inc.
2
+
3
+ #include "mlx/event.h"
4
+ #include "mlx/backend/metal/device.h"
5
+ #include "mlx/scheduler.h"
6
+
7
+ namespace mlx::core {
8
+
9
+ Event::Event(Stream stream) : stream_(stream) {
10
+ auto dtor = [](void* ptr) {
11
+ auto p = metal::new_scoped_memory_pool();
12
+ static_cast<MTL::SharedEvent*>(ptr)->release();
13
+ };
14
+ auto p = metal::new_scoped_memory_pool();
15
+ event_ = std::shared_ptr<void>(
16
+ metal::device(Device::gpu).mtl_device()->newSharedEvent(), dtor);
17
+ if (event_ == nullptr) {
18
+ throw std::runtime_error(
19
+ "[Event::Event] Failed to create Metal shared event.");
20
+ }
21
+ }
22
+
23
+ void Event::wait() {
24
+ if (!static_cast<MTL::SharedEvent*>(event_.get())
25
+ ->waitUntilSignaledValue(value(), -1)) {
26
+ throw std::runtime_error("[Event::wait] Timed out");
27
+ }
28
+ }
29
+
30
+ void Event::wait(Stream stream) {
31
+ if (stream.device == Device::cpu) {
32
+ scheduler::enqueue(stream, [*this]() mutable { wait(); });
33
+ } else {
34
+ auto& d = metal::device(stream.device);
35
+ d.end_encoding(stream.index);
36
+ auto command_buffer = d.get_command_buffer(stream.index);
37
+ command_buffer->encodeWait(static_cast<MTL::Event*>(event_.get()), value());
38
+ command_buffer->addCompletedHandler([*this](MTL::CommandBuffer*) {});
39
+ }
40
+ }
41
+
42
+ void Event::signal(Stream stream) {
43
+ if (stream.device == Device::cpu) {
44
+ scheduler::enqueue(stream, [*this]() mutable {
45
+ static_cast<MTL::SharedEvent*>(event_.get())->setSignaledValue(value());
46
+ });
47
+ } else {
48
+ auto& d = metal::device(stream.device);
49
+ d.end_encoding(stream.index);
50
+ auto command_buffer = d.get_command_buffer(stream.index);
51
+ command_buffer->encodeSignalEvent(
52
+ static_cast<MTL::Event*>(event_.get()), value());
53
+ command_buffer->addCompletedHandler([*this](MTL::CommandBuffer*) {});
54
+ }
55
+ }
56
+
57
+ bool Event::is_signaled() const {
58
+ return static_cast<MTL::SharedEvent*>(event_.get())->signaledValue() >=
59
+ value();
60
+ }
61
+
62
+ } // namespace mlx::core
@@ -0,0 +1,162 @@
1
+ // Copyright © 2024 Apple Inc.
2
+ #include "mlx/fence.h"
3
+ #include "mlx/backend/metal/device.h"
4
+ #include "mlx/scheduler.h"
5
+ #include "mlx/utils.h"
6
+
7
+ namespace mlx::core {
8
+
9
+ struct FenceImpl {
10
+ FenceImpl() {
11
+ auto d = metal::device(Device::gpu).mtl_device();
12
+ if (!d->supportsFamily(MTL::GPUFamilyMetal3)) {
13
+ use_fast = false;
14
+ } else if (__builtin_available(macOS 15, iOS 18, *)) {
15
+ use_fast = env::metal_fast_synch();
16
+ }
17
+
18
+ if (!use_fast) {
19
+ auto p = metal::new_scoped_memory_pool();
20
+ fence = static_cast<void*>(d->newSharedEvent());
21
+ } else {
22
+ auto buf = allocator::malloc(sizeof(uint32_t)).ptr();
23
+ fence = static_cast<void*>(buf);
24
+ cpu_value()[0] = 0;
25
+ }
26
+ }
27
+
28
+ ~FenceImpl() {
29
+ if (!use_fast) {
30
+ // Wraps Metal SharedEvent
31
+ auto p = metal::new_scoped_memory_pool();
32
+ static_cast<MTL::SharedEvent*>(fence)->release();
33
+ } else {
34
+ allocator::free(allocator::Buffer{static_cast<MTL::Buffer*>(fence)});
35
+ }
36
+ }
37
+ bool use_fast{false};
38
+ uint32_t count{0};
39
+ void* fence;
40
+
41
+ std::atomic_uint* cpu_value() {
42
+ return static_cast<std::atomic_uint*>(
43
+ static_cast<MTL::Buffer*>(fence)->contents());
44
+ }
45
+ };
46
+
47
+ Fence::Fence(Stream) {
48
+ auto dtor = [](void* ptr) { delete static_cast<FenceImpl*>(ptr); };
49
+ fence_ = std::shared_ptr<void>(new FenceImpl{}, dtor);
50
+ }
51
+
52
+ void Fence::wait(Stream stream, const array& x) {
53
+ auto& f = *static_cast<FenceImpl*>(fence_.get());
54
+
55
+ if (stream.device == Device::cpu) {
56
+ scheduler::enqueue(stream, [fence_ = fence_, count = f.count]() mutable {
57
+ auto& f = *static_cast<FenceImpl*>(fence_.get());
58
+ if (!f.use_fast) {
59
+ if (!static_cast<MTL::SharedEvent*>(f.fence)->waitUntilSignaledValue(
60
+ count, -1)) {
61
+ throw std::runtime_error("[Fence::wait] Timed out");
62
+ }
63
+ return;
64
+ }
65
+ while (f.cpu_value()[0] < count) {
66
+ }
67
+ });
68
+ return;
69
+ }
70
+
71
+ auto& d = metal::device(stream.device);
72
+ auto idx = stream.index;
73
+
74
+ if (!f.use_fast) {
75
+ d.end_encoding(idx);
76
+ auto command_buffer = d.get_command_buffer(idx);
77
+ command_buffer->encodeWait(static_cast<MTL::Event*>(f.fence), f.count);
78
+ command_buffer->addCompletedHandler(
79
+ [fence_ = fence_](MTL::CommandBuffer* cbuf) {});
80
+ return;
81
+ }
82
+
83
+ auto& compute_encoder = d.get_command_encoder(idx);
84
+
85
+ // Register outputs to ensure that no kernels which depends on the
86
+ // output starts before this one is done
87
+ compute_encoder.register_output_array(x);
88
+
89
+ auto kernel = d.get_kernel("fence_wait");
90
+ MTL::Size kernel_dims = MTL::Size(1, 1, 1);
91
+ compute_encoder.set_compute_pipeline_state(kernel);
92
+
93
+ auto buf = static_cast<MTL::Buffer*>(f.fence);
94
+ compute_encoder.set_buffer(buf, 0);
95
+ compute_encoder.set_bytes(f.count, 1);
96
+ compute_encoder.dispatch_threads(kernel_dims, kernel_dims);
97
+
98
+ d.get_command_buffer(idx)->addCompletedHandler(
99
+ [fence_ = fence_](MTL::CommandBuffer* cbuf) {});
100
+ }
101
+
102
+ void Fence::update(Stream stream, const array& x, bool cross_device) {
103
+ auto& f = *static_cast<FenceImpl*>(fence_.get());
104
+ f.count++;
105
+
106
+ if (stream.device == Device::cpu) {
107
+ scheduler::enqueue(stream, [fence_ = fence_, count = f.count]() mutable {
108
+ auto& f = *static_cast<FenceImpl*>(fence_.get());
109
+ if (!f.use_fast) {
110
+ static_cast<MTL::SharedEvent*>(f.fence)->setSignaledValue(count);
111
+ return;
112
+ }
113
+
114
+ f.cpu_value()[0] = count;
115
+ });
116
+ return;
117
+ }
118
+
119
+ auto& d = metal::device(stream.device);
120
+ auto idx = stream.index;
121
+ if (!f.use_fast) {
122
+ d.end_encoding(idx);
123
+ auto command_buffer = d.get_command_buffer(idx);
124
+ command_buffer->encodeSignalEvent(
125
+ static_cast<MTL::Event*>(f.fence), f.count);
126
+ command_buffer->addCompletedHandler(
127
+ [fence_ = fence_](MTL::CommandBuffer* cbuf) {});
128
+ return;
129
+ }
130
+
131
+ // Launch input visibility kernels
132
+ auto& compute_encoder = d.get_command_encoder(idx);
133
+ if (cross_device) {
134
+ auto kernel = d.get_kernel("input_coherent");
135
+ uint32_t nthreads = (x.data_size() * x.itemsize() + sizeof(uint32_t) - 1) /
136
+ sizeof(uint32_t);
137
+ MTL::Size group_dims = MTL::Size(1024, 1, 1);
138
+ MTL::Size grid_dims = MTL::Size((nthreads + 1024 - 1) / 1024, 1, 1);
139
+ compute_encoder.set_compute_pipeline_state(kernel);
140
+ compute_encoder.set_input_array(x, 0);
141
+ compute_encoder.set_bytes(nthreads, 1);
142
+ compute_encoder.dispatch_threadgroups(grid_dims, group_dims);
143
+ }
144
+
145
+ // Barrier on previous kernels
146
+ compute_encoder.barrier();
147
+
148
+ // Launch value update kernel
149
+ auto kernel = d.get_kernel("fence_update");
150
+ MTL::Size kernel_dims = MTL::Size(1, 1, 1);
151
+ compute_encoder.set_compute_pipeline_state(kernel);
152
+
153
+ auto buf = static_cast<MTL::Buffer*>(f.fence);
154
+ compute_encoder.set_buffer(buf, 0);
155
+ compute_encoder.set_bytes(f.count, 1);
156
+ compute_encoder.dispatch_threads(kernel_dims, kernel_dims);
157
+
158
+ d.get_command_buffer(idx)->addCompletedHandler(
159
+ [fence_ = fence_](MTL::CommandBuffer* cbuf) {});
160
+ }
161
+
162
+ } // namespace mlx::core