Manuel Villanueva 
							
						 
					 
					
						
						
							
						
						9cbb1b0148 
					 
					
						
						
							
							Modified sort behavior when running CPU or Metal to match NumPy/JAX ( #2667 )  
						
						 
						
						... 
						
						
						
						* Modified sort behavior when running CPU or Metal to match NumPy/JAX sorting behavior.
* Modified sort behavior when running CPU or Metal to match NumPy/JAX
* nits
---------
Co-authored-by: Awni Hannun <awni@apple.com > 
						
						
					 
					
						2025-10-13 14:36:45 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						630350ad3e 
					 
					
						
						
							
							Precise sigmoid ( #2659 )  
						
						 
						
						... 
						
						
						
						* bump patch
* Sigmoid matches PyTorch and is more precise on tails 
						
						
					 
					
						2025-10-10 10:05:23 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						380aeb58ae 
					 
					
						
						
							
							enable admm low-precision cpu ( #2661 )  
						
						 
						
						
						
						
					 
					
						2025-10-10 09:50:54 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						e89e8b4272 
					 
					
						
						
							
							Export with callback ( #2612 )  
						
						 
						
						... 
						
						
						
						* export with callback
* export with callback
* Add types, fix kwarg ordering bug + test
* cleanup, test, fix
* typos 
						
						
					 
					
						2025-10-08 19:24:33 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								AN Long 
							
						 
					 
					
						
						
							
						
						85a8824a8c 
					 
					
						
						
							
							Fix cumulative operations when axis=None ( #2653 )  
						
						 
						
						
						
						
					 
					
						2025-10-08 15:25:38 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						343e33b6d5 
					 
					
						
						
							
							fix all_gather vjp ( #2654 )  
						
						 
						
						
						
						
					 
					
						2025-10-07 06:05:23 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						a7a94b29d7 
					 
					
						
						
							
							Fix compile when outputs change ( #2648 )  
						
						 
						
						
						
						
					 
					
						2025-10-03 08:40:57 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						1c9ae1eaa1 
					 
					
						
						
							
							cuda fix flaky test ( #2646 )  
						
						 
						
						
						
						
					 
					
						2025-10-02 15:40:04 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						e88f2d4a8e 
					 
					
						
						
							
							fix cross entropy axis param ( #2641 )  
						
						 
						
						... 
						
						
						
						* fix cross entropy axis param
* faster grad clipping 
						
						
					 
					
						2025-10-01 16:49:55 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Angelos Katharopoulos 
							
						 
					 
					
						
						
							
						
						eb24267b56 
					 
					
						
						
							
							Compile now can attach arbitrary data to an entry ( #2634 )  
						
						 
						
						
						
						
					 
					
						2025-09-30 13:33:27 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						dc371ae7a5 
					 
					
						
						
							
							fix for max block dim ( #2631 )  
						
						 
						
						
						
						
					 
					
						2025-09-29 08:59:25 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						d4f4ff3c5e 
					 
					
						
						
							
							Allow None input to compiled functions ( #2621 )  
						
						 
						
						... 
						
						
						
						* Allow None input to compiled functions
* Allow None input to compiled functions 
						
						
					 
					
						2025-09-25 08:42:23 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Daniel Yeh 
							
						 
					 
					
						
						
							
						
						fbbf3b9b3e 
					 
					
						
						
							
							Support pickling array for bfloat16 ( #2586 )  
						
						 
						
						... 
						
						
						
						* add bfloat16 pickling
* Improvements
* improve
---------
Co-authored-by: Chen-Chen Yeh <ge96noj@mytum.de > 
						
						
					 
					
						2025-09-22 20:12:15 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						711a645807 
					 
					
						
						
							
							avoid producing NaN in attention ( #2608 )  
						
						 
						
						
						
						
					 
					
						2025-09-22 13:10:43 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Josh Bleecher Snyder 
							
						 
					 
					
						
						
							
						
						aa9d44b3d4 
					 
					
						
						
							
							implement Convolution::output_shape ( #2601 )  
						
						 
						
						... 
						
						
						
						- pull conv_out_shape out for re-use
- add Conv::output_shape
- add e2e python tests confirming shapeless=True support and correctness
Updates #2599  
						
						
					 
					
						2025-09-22 10:09:45 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						787c0d90cd 
					 
					
						
						
							
							Detect cache thrashing in LRUCache ( #2600 )  
						
						 
						
						... 
						
						
						
						* Detect cache thrashing in LRUCache
* Do not check cache thrashing in tests 
						
						
					 
					
						2025-09-19 09:12:14 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						50cc09887f 
					 
					
						
						
							
							expose depends ( #2606 )  
						
						 
						
						
						
						
					 
					
						2025-09-18 10:06:15 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						6a3acf2301 
					 
					
						
						
							
							[CUDA] Set bias as input when using bias epilogue ( #2584 )  
						
						 
						
						
						
						
					 
					
						2025-09-11 15:31:09 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						d6977f2a57 
					 
					
						
						
							
							Add sdpa with sinks ( #2558 )  
						
						 
						
						... 
						
						
						
						* add sdpa with sinks
* fix 2 pass
* fix matrix sdpa
* fix perf regression
* add to cuda (#2580 ) 
						
						
					 
					
						2025-09-10 14:53:00 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Gökdeniz Gülmez 
							
						 
					 
					
						
						
							
						
						db5443e831 
					 
					
						
						
							
							Adding Relu2 ( #2582 )  
						
						 
						
						... 
						
						
						
						* in. com.
* upd. ackn.
* update __init__
* nits
* nits + format
* used mx.maximum(x, 0) instead of calling the function and moves relu6 under relu2 to make it nicer
* same with _make_activation_module
* Update python/mlx/nn/layers/activations.py
upd
Co-authored-by: Awni Hannun <awni.hannun@gmail.com >
* update funct.rst
* upd. layers.rst
---------
Co-authored-by: Awni Hannun <awni.hannun@gmail.com > 
						
						
					 
					
						2025-09-10 07:24:30 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						52b8384d10 
					 
					
						
						
							
							Fix flaky addmm tests ( #2581 )  
						
						 
						
						
						
						
					 
					
						2025-09-10 14:22:22 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						44cc5da4bc 
					 
					
						
						
							
							[CUDA] Fix alpha not respected when using bias epilogue ( #2578 )  
						
						 
						
						
						
						
					 
					
						2025-09-10 09:08:01 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						17310d91a6 
					 
					
						
						
							
							Add batch offsets for mx.fast.rope ( #2564 )  
						
						 
						
						... 
						
						
						
						* implement batch rope for Metal
* cuda rope (#2576 ) 
						
						
					 
					
						2025-09-08 17:35:07 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						a44b27f5f8 
					 
					
						
						
							
							Fix a few ccache cache miss ( #2573 )  
						
						 
						
						... 
						
						
						
						* Fix ccache cache miss
* Do not define _VERSION_ in python bindings 
						
						
					 
					
						2025-09-09 07:41:05 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								XXXXRT666 
							
						 
					 
					
						
						
							
						
						8f163a367d 
					 
					
						
						
							
							typing: add type hints to mlx.core.array, linalg, distributed, and random ( #2565 )  
						
						 
						
						... 
						
						
						
						* Add type annotations to mlx methods
* Missing list_or_scalar 
						
						
					 
					
						2025-09-04 09:08:11 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Manuel Villanueva 
							
						 
					 
					
						
						
							
						
						89a3df9014 
					 
					
						
						
							
							Fixed several type annotations in the MLX stubs which degraded to Unknown/Any ( #2560 )  
						
						 
						
						... 
						
						
						
						* Added scalar to stubs to fix Unkown Type Hint
### Proposed changes
Issue #2478  reports that several type annotations in the MLX stubs degrade to Unknown/Any in editors like VS Code with Pylance, due to missing imports (Union, Optional, Tuple) and an undefined scalar type alias.
This PR updates the stub generation patterns to:
	•	Add missing typing imports in mlx.core.__prefix__ so that Union, Optional, Tuple, etc. are always available.
	•	Define and export scalar: TypeAlias = Union[int, float, bool] in mlx.core.__suffix__ so that functions typed with Union[scalar, array] resolve correctly instead of falling back to Any.
	•	Update submodule stub prefixes (distributed, fast, linalg, metal, random) to import scalar alongside array, Device, and Stream, ensuring type checkers resolve the union consistently across modules.
With these changes, functions like mlx.add now display rich type signatures such as:
```
def add(
    a: scalar | array,
    b: scalar | array,
    stream: Stream | Device | None = None
) -> array
```
instead of degrading to Any.
### Checklist
	•	I have read the CONTRIBUTING document
	•	I have run pre-commit run --all-files to format my code / installed pre-commit prior to committing changes
	•	I have added tests that prove my fix is effective or that my feature works (n/a — stub generation only)
	•	I have updated the necessary documentation (if needed)
* add bool to patterns
---------
Co-authored-by: Awni Hannun <awni@apple.com > 
						
						
					 
					
						2025-09-03 12:52:08 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						b61a65e313 
					 
					
						
						
							
							fix copies in sdpa ( #2563 )  
						
						 
						
						
						
						
					 
					
						2025-09-02 11:00:36 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								wrmsr 
							
						 
					 
					
						
						
							
						
						04cbb4191c 
					 
					
						
						
							
							Fix dequantize python sig ( #2562 )  
						
						 
						
						
						
						
					 
					
						2025-09-01 11:50:20 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Artur Antonov 
							
						 
					 
					
						
						
							
						
						c5460762e7 
					 
					
						
						
							
							Fix AdamW weight_decay default value in docstring ( #2557 )  
						
						 
						
						
						
						
					 
					
						2025-08-31 21:29:30 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						8ce49cd39e 
					 
					
						
						
							
							fix quantized vjp for mxfp4 ( #2555 )  
						
						 
						
						
						
						
					 
					
						2025-08-29 10:06:15 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						111f1e71af 
					 
					
						
						
							
							Faster contiguous gather for indices in the first axis ( #2552 )  
						
						 
						
						... 
						
						
						
						* faster contiguous gather for indices in the first axis
* work per thread > 1
* angelos suggestion for scales / biases 
						
						
					 
					
						2025-08-28 21:26:30 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						70560b6bd5 
					 
					
						
						
							
							Add mode parameter for quantization ( #2499 )  
						
						 
						
						... 
						
						
						
						* add mode parameter for quantization
* mxfp4 quantize/dequantize + start of optional biases
* mxfp4 works
* speedup
* cpu mxfp4
* fix
* fix test tol
* fix
* refactor
* add quant mode enum 
						
						
					 
					
						2025-08-28 06:45:26 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						7ef8a6f2d5 
					 
					
						
						
							
							[CUDA] fix sort ( #2550 )  
						
						 
						
						... 
						
						
						
						* [CUDA] fix sort
* fix test 
						
						
					 
					
						2025-08-27 19:48:43 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						5458d43247 
					 
					
						
						
							
							add load with path tests ( #2543 )  
						
						 
						
						
						
						
					 
					
						2025-08-26 14:24:47 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						3dcb286baf 
					 
					
						
						
							
							Remove stream from average grads so it uses default ( #2532 )  
						
						 
						
						... 
						
						
						
						* Remove stream from average grads so it uses default
* comment 
						
						
					 
					
						2025-08-25 15:56:29 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						4822c3dbe9 
					 
					
						
						
							
							[CUDA] Implement DynamicSlice/DynamicSliceUpdate ( #2533 )  
						
						 
						
						... 
						
						
						
						* Move DynamicSlice to gpu/primitives
* Implement compute_dynamic_offset in CUDA 
						
						
					 
					
						2025-08-26 07:31:39 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						db14e29a0b 
					 
					
						
						
							
							allow pathlib.Path to save/load functions ( #2541 )  
						
						 
						
						
						
						
					 
					
						2025-08-25 14:58:49 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						068a4612e9 
					 
					
						
						
							
							nccl default for backend=any ( #2528 )  
						
						 
						
						... 
						
						
						
						* nccl default for backend=any
* check num gpus + ensure row contiguous for all reduce
* comment 
						
						
					 
					
						2025-08-22 12:24:27 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						f93f87c802 
					 
					
						
						
							
							nccl dep + default for cuda ( #2526 )  
						
						 
						
						
						
						
					 
					
						2025-08-21 17:57:49 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Anastasiia Filippova 
							
						 
					 
					
						
						
							
						
						9392fc3f88 
					 
					
						
						
							
							NCCL backend ( #2476 )  
						
						 
						
						
						
						
					 
					
						2025-08-21 11:56:15 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						e843c4d8d5 
					 
					
						
						
							
							fix power ( #2523 )  
						
						 
						
						
						
						
					 
					
						2025-08-21 06:46:01 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Angelos Katharopoulos 
							
						 
					 
					
						
						
							
						
						e397177f6e 
					 
					
						
						
							
							Custom cuda kernel ( #2517 )  
						
						 
						
						
						
						
					 
					
						2025-08-20 17:20:22 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						f4c8888cbe 
					 
					
						
						
							
							[CUDA] Fix stride of singleton dims before passing to cuDNN ( #2521 )  
						
						 
						
						
						
						
					 
					
						2025-08-21 08:55:26 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Angelos Katharopoulos 
							
						 
					 
					
						
						
							
						
						25c1e03205 
					 
					
						
						
							
							Fix overflow in large filter small channels ( #2520 )  
						
						 
						
						
						
						
					 
					
						2025-08-20 08:03:29 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						ac85ddfdb7 
					 
					
						
						
							
							[CUDA] Add GEMM-based fallback convolution kernels ( #2511 )  
						
						 
						
						... 
						
						
						
						* Add gemm_conv
* Add gemm_grouped_conv 
						
						
					 
					
						2025-08-20 10:06:22 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						e7c6e1db82 
					 
					
						
						
							
							no segfault with uninitialized array.at ( #2514 )  
						
						 
						
						
						
						
					 
					
						2025-08-18 08:33:38 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						c5fcd5b61b 
					 
					
						
						
							
							fix custom kernel test ( #2510 )  
						
						 
						
						
						
						
					 
					
						2025-08-18 06:45:59 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Cheng 
							
						 
					 
					
						
						
							
						
						1ba18ff7d9 
					 
					
						
						
							
							[CUDA] Fix conv grads with groups ( #2495 )  
						
						 
						
						... 
						
						
						
						* Put reshape utils in one file
* [CUDA] Fix conv grads with groups
* Put the reshape utils in gpu/copy.h 
						
						
					 
					
						2025-08-16 10:09:18 +09:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Luca Vivona 
							
						 
					 
					
						
						
							
						
						728d4db582 
					 
					
						
						
							
							Support destination arg in tree flatten/unflatten ( #2450 )  
						
						 
						
						
						
						
					 
					
						2025-08-06 15:34:59 -07:00  
					
					
						 
						
						
							
							
							 
							
							
							
							
							 
						
					 
				 
			
				
					
						
							
							
								 
								Awni Hannun 
							
						 
					 
					
						
						
							
						
						fa89f0b150 
					 
					
						
						
							
							faster gather qmm sorted test ( #2463 )  
						
						 
						
						
						
						
					 
					
						2025-08-05 06:27:40 -07:00