base on Swift API for MLX # MLX Swift [**Installation**](#installation) | [**Documentation**](https://swiftpackageindex.com/ml-explore/mlx-swift/main/documentation/mlx) | [**Examples**](https://swiftpackageindex.com/ml-explore/mlx-swift/main/documentation/mlx/examples) MLX Swift is a Swift API for [MLX](https://ml-explore.github.io/mlx/build/html/index.html). MLX is an array framework for machine learning on Apple silicon. MLX Swift expands MLX to the Swift language, making research and experimentation easier on Apple silicon. ## Examples MLX Swift has a [few examples](https://swiftpackageindex.com/ml-explore/mlx-swift/main/documentation/mlx/examples), including: - Large-scale text generation with Mistral 7B - Training a simple LeNet on MNIST - Examples that run on macOS or iOS The [MLX Swift Examples repo](https://github.com/ml-explore/mlx-swift-examples) contains the complete code and documentation for these examples. ## Installation The ``MLX`` Swift package can be built and run from Xcode or SwiftPM. A CMake install is also provided. More details are in the [documentation](https://swiftpackageindex.com/ml-explore/mlx-swift/main/documentation/mlx/install). ### Xcode In Xcode you can add `https://github.com/ml-explore/mlx-swift` as a package dependency and link `MLX`, `MLXNN`, `MLXOptimizers` and `MLXRandom` as needed. ### SwiftPM To use ``MLX`` with SwiftPM you can add this to your `Package.swift`: ```swift dependencies: [ .package(url: "https://github.com/ml-explore/mlx-swift", from: "0.10.0") ] ``` and add the libraries as dependencies: ```swift dependencies: [.product(name: "MLX", package: "mlx-swift"), .product(name: "MLXRandom", package: "mlx-swift"), .product(name: "MLXNN", package: "mlx-swift"), .product(name: "MLXOptimizers", package: "mlx-swift"), .product(name: "MLXFFT", package: "mlx-swift")] ``` > [!Note] > SwiftPM (command line) cannot build the Metal shaders so the ultimate build has to be done > via Xcode. ### xcodebuild Although `SwiftPM` (command line) cannot build the Metal shaders, `xcodebuild` can and it can be used to do command line builds: ``` # build and run tests xcodebuild test -scheme mlx-swift-Package -destination 'platform=OS X' # build Tutorial xcodebuild build -scheme Tutorial -destination 'platform=OS X' ``` ### CMake Building with CMake requires both CMake and Ninja to be installed. You can do this with [Homebrew](https://brew.sh/): ```shell brew install cmake brew install ninja ``` With CMake: ```shell mkdir build cd build cmake .. -G Ninja ninja ./example ``` ## Contributing Check out the [contribution guidelines](CONTRIBUTING.md) for more information on contributing to MLX. See the [docs](https://swiftpackageindex.com/ml-explore/mlx-swift/main/documentation/mlx/install) for more information on building from source, and running tests. We are grateful for all of [our contributors](ACKNOWLEDGMENTS.md#Individual-Contributors). If you contribute to MLX Swift and wish to be acknowledged, please add your name to the list in your pull request. MLX Swift was initially developed by David Koski and Ronan Collobert, and is now maintained by David Koski. MLX Swift is built on top of [MLX](https://github.com/ml-explore/mlx), which was initially developed with equal contribution by Awni Hannun, Jagrit Digani, Angelos Katharopoulos, and Ronan Collobert. ## Versions The ``MLX`` array functions should match MLX as of tag [v0.3.0](https://github.com/ml-explore/mlx/releases/tag/v0.3.0). The `MLXNN` package should match MLX (`mlx.nn`) as of tag [v0.0.10](https://github.com/ml-explore/mlx/releases/tag/v0.0.10). ", Assign "at most 3 tags" to the expected json: {"id":"11188","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"