h3-image-mlx 0.1.0a1__tar.gz

h3_image_mlx-0.1.0a1/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

h3_image_mlx-0.1.0a1/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: h3-image-mlx
+Version: 0.1.0a1
+Summary: Local MiniMax H3 Image generation and editing with MLX on Apple Silicon
+License-Expression: Apache-2.0 AND MIT
+Project-URL: Source, https://github.com/Anionex/h3-image-mlx
+Project-URL: Issues, https://github.com/Anionex/h3-image-mlx/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: src/h3_image_mlx/kernels/LICENSE
+Requires-Dist: mlx<0.33,>=0.32.3
+Requires-Dist: numpy>=1.26
+Requires-Dist: Pillow>=10
+Requires-Dist: tokenizers<0.24,>=0.21
+Requires-Dist: httpx<1,>=0.27
+Dynamic: license-file
+
+# H3 Image MLX
+
+Generate and edit images locally with MiniMax H3 Image and the Comfy-Org INT8 ConvRot weights. The runtime accepts ordered reference files and runs the text encoder, optional reference VAE, six-step DiT and image decoder in separate processes.
+
+## Install
+
+Use Python 3.11+ on an Apple Silicon Mac with Metal. In a fresh environment, install the alpha release:
+
+```bash
+uv venv --python 3.13
+uv pip install 'h3-image-mlx==0.1.0a1'
+source .venv/bin/activate
+```
+
+## Model files
+
+Supply a directory containing these five files. Their source revisions, sizes and SHA-256 digests are pinned in the package's `weights.json`. You can reuse an existing model directory or link to its files. A fresh download needs 49.30 GB of disk space. The runtime loads all weights locally. Review the [MiniMax model license](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image/blob/main/LICENSE) for its territorial, use and distribution terms before fetching or using the model.
+
+```text
+diffusion_models/minimax_h3_image_pruned_int8_convrot.safetensors
+text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors
+vae/minimax_h3_image_vae_fp16.safetensors
+vae/config.json
+tokenizer.json
+```
+
+```bash
+h3-image-mlx verify --models ./models
+# To fetch the five files into an empty directory, select a source:
+h3-image-mlx fetch --models ./models --source modelscope
+# --source huggingface selects the pinned Hugging Face files instead.
+```
+
+## Generate and edit
+
+```bash
+h3-image-mlx generate --models ./models --prompt 'A yellow enamel teapot on a blue wooden table' --output teapot.png
+h3-image-mlx generate --models ./models --reference teapot.png --reference bird.png \
+  --prompt 'Edit <Picture 1>. Replace the cup with the bird from <Picture 2>.' --output edit.png
+```
+
+```python
+from h3_image_mlx import generate
+
+im = generate("A red fox in fresh snow", models="./models", width=1024, height=1024,
+              seed=42, dit_mode="stream")
+im.save("fox.png")
+```
+
+Images are RGB. Use multiples of 32 from 256 to 4096 for each dimension. Pass up to 16 references in order using repeated `--reference` or the `references` argument. The original desktop pipeline completed single- and two-reference edits on the M5 Pro; its 16-reference run reached denoising step three before cancellation.
+
+## Hardware and memory
+
+`--backend auto` selects the W8A8 TensorOps kernel on M5/M6 and the experimental portable path on earlier Apple GPUs. M5 Pro 48 GB is the physically tested hardware. M1–M4 and M6 need on-device validation. Explicit choices are `w8a8` and `portable`.
+
+`--dit-mode stream` reads DiT weights one layer at a time; `resident` keeps them between denoising steps. The default `auto` streams when using the portable backend, on machines with less than 32 GiB, or above 8192 packed sequence rows. This selection heuristic does not establish minimum supported machine memory.
+
+Existing installations with the four weight and tokenizer files can run `fetch` once to verify them and add the 1,826-byte VAE configuration.
+
+## Attribution
+
+This project’s own runtime code is licensed under Apache-2.0. The model and third-party kernels retain their respective licenses.
+
+MiniMax developed [H3 Image](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image). [Comfy-Org](https://huggingface.co/Comfy-Org/MiniMax-H3-Image) provides the pinned quantized weights. The VAE configuration downloads separately from the official [VAE config](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image/blob/492fd8c4eca666f1085f57e30738c1e0d86b3439/vae/config.json). The upstream model agreement and attribution are included in the package. The three W8A8 Metal source files come from [mlx-serve](https://github.com/ddalcu/mlx-serve/tree/9191fbdf697df333cac19ec7a93eaa1098ce3ad5/src/kernels) with their MIT license.

h3_image_mlx-0.1.0a1/README.md

@@ -0,0 +1,64 @@
+# H3 Image MLX
+
+Generate and edit images locally with MiniMax H3 Image and the Comfy-Org INT8 ConvRot weights. The runtime accepts ordered reference files and runs the text encoder, optional reference VAE, six-step DiT and image decoder in separate processes.
+
+## Install
+
+Use Python 3.11+ on an Apple Silicon Mac with Metal. In a fresh environment, install the alpha release:
+
+```bash
+uv venv --python 3.13
+uv pip install 'h3-image-mlx==0.1.0a1'
+source .venv/bin/activate
+```
+
+## Model files
+
+Supply a directory containing these five files. Their source revisions, sizes and SHA-256 digests are pinned in the package's `weights.json`. You can reuse an existing model directory or link to its files. A fresh download needs 49.30 GB of disk space. The runtime loads all weights locally. Review the [MiniMax model license](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image/blob/main/LICENSE) for its territorial, use and distribution terms before fetching or using the model.
+
+```text
+diffusion_models/minimax_h3_image_pruned_int8_convrot.safetensors
+text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors
+vae/minimax_h3_image_vae_fp16.safetensors
+vae/config.json
+tokenizer.json
+```
+
+```bash
+h3-image-mlx verify --models ./models
+# To fetch the five files into an empty directory, select a source:
+h3-image-mlx fetch --models ./models --source modelscope
+# --source huggingface selects the pinned Hugging Face files instead.
+```
+
+## Generate and edit
+
+```bash
+h3-image-mlx generate --models ./models --prompt 'A yellow enamel teapot on a blue wooden table' --output teapot.png
+h3-image-mlx generate --models ./models --reference teapot.png --reference bird.png \
+  --prompt 'Edit <Picture 1>. Replace the cup with the bird from <Picture 2>.' --output edit.png
+```
+
+```python
+from h3_image_mlx import generate
+
+im = generate("A red fox in fresh snow", models="./models", width=1024, height=1024,
+              seed=42, dit_mode="stream")
+im.save("fox.png")
+```
+
+Images are RGB. Use multiples of 32 from 256 to 4096 for each dimension. Pass up to 16 references in order using repeated `--reference` or the `references` argument. The original desktop pipeline completed single- and two-reference edits on the M5 Pro; its 16-reference run reached denoising step three before cancellation.
+
+## Hardware and memory
+
+`--backend auto` selects the W8A8 TensorOps kernel on M5/M6 and the experimental portable path on earlier Apple GPUs. M5 Pro 48 GB is the physically tested hardware. M1–M4 and M6 need on-device validation. Explicit choices are `w8a8` and `portable`.
+
+`--dit-mode stream` reads DiT weights one layer at a time; `resident` keeps them between denoising steps. The default `auto` streams when using the portable backend, on machines with less than 32 GiB, or above 8192 packed sequence rows. This selection heuristic does not establish minimum supported machine memory.
+
+Existing installations with the four weight and tokenizer files can run `fetch` once to verify them and add the 1,826-byte VAE configuration.
+
+## Attribution
+
+This project’s own runtime code is licensed under Apache-2.0. The model and third-party kernels retain their respective licenses.
+
+MiniMax developed [H3 Image](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image). [Comfy-Org](https://huggingface.co/Comfy-Org/MiniMax-H3-Image) provides the pinned quantized weights. The VAE configuration downloads separately from the official [VAE config](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image/blob/492fd8c4eca666f1085f57e30738c1e0d86b3439/vae/config.json). The upstream model agreement and attribution are included in the package. The three W8A8 Metal source files come from [mlx-serve](https://github.com/ddalcu/mlx-serve/tree/9191fbdf697df333cac19ec7a93eaa1098ce3ad5/src/kernels) with their MIT license.

h3_image_mlx-0.1.0a1/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "h3-image-mlx"
+version = "0.1.0a1"
+description = "Local MiniMax H3 Image generation and editing with MLX on Apple Silicon"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "Apache-2.0 AND MIT"
+license-files = ["LICENSE", "src/h3_image_mlx/kernels/LICENSE"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Operating System :: MacOS :: MacOS X",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = ["mlx>=0.32.3,<0.33", "numpy>=1.26", "Pillow>=10", "tokenizers>=0.21,<0.24", "httpx>=0.27,<1"]
+
+[project.urls]
+Source = "https://github.com/Anionex/h3-image-mlx"
+Issues = "https://github.com/Anionex/h3-image-mlx/issues"
+
+[project.scripts]
+h3-image-mlx = "h3_image_mlx.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+h3_image_mlx = ["kernels/*.metal", "kernels/LICENSE", "weights.json", "MODEL_LICENSE.txt", "NOTICE.txt"]

h3_image_mlx-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

h3_image_mlx-0.1.0a1/src/h3_image_mlx/MODEL_LICENSE.txt

@@ -0,0 +1,84 @@
+MiniMax-H3-Image COMMUNITY LICENSE AGREEMENT
+MiniMax-H3-Image release date/License date: November 10, 2026.
+The scope of this License Agreement (this “Agreement”) is expressly limited to the “Applicable Territory” as defined below.
+By clicking to accept, or by using, reproducing, modifying, distributing, running, or displaying any portion or element of the MiniMax-H3-Image Works (including through any Hosted Service) in any manner, you acknowledge and accept the terms of this Agreement, and this Agreement shall take immediate effect upon the occurrence of such act.
+I.  Definitions
+1. “Acceptable Use Policy” means the policy published by MiniMax in Exhibit A.
+2. “Agreement” means the terms and conditions set forth herein that govern the use, reproduction, distribution, modification, running, and display of the MiniMax-H3-Image Works or any portion or element thereof.
+3. “Applicable Territory” means worldwide, excluding the Excluded Territories.
+4. “Documentation” means the specifications, manuals, and documentation concerning MiniMax-H3-Image that are publicly released by MiniMax.
+5. “Excluded Territories” means the European Union, the United Kingdom, the Republic of Korea and the United States of America.  
+6. “MiniMax-H3-Image” means the image generation model, together with its software and algorithms, including trained model weights, parameters (including optimizer states), prompt-enhancement models, inference-supporting code, and other elements thereof made publicly available by Us, as released at https://huggingface.co/MiniMaxAI/MiniMax-H3-Image.
+7. “MiniMax-H3-Image Works” means (i) the Materials, (ii) the Model Derivatives, and (iii) all derivatives thereof.
+8. “Hosted Service” means a service through which MiniMax-H3-Image or its Model Derivatives is hosted or operated and its functionality is made available to Third Parties, including via application programming interfaces (APIs), web access, or any other electronic or remote means.
+9. “Licensee,” “you,” or “your” means the natural or legal person exercising rights and/or using the MiniMax-H3-Image Works for any purpose in any field of use under this Agreement.
+10. “Materials” means, collectively, MiniMax-H3-Image and the Documentation (and any portion thereof), in each case as made available by MiniMax under this Agreement and proprietary to MiniMax.
+11. “Model Derivatives” means all of the following: (i) any modification of MiniMax-H3-Image or any Model Derivative thereof; (ii) any work based on MiniMax-H3-Image or any Model Derivative thereof; or (iii) any other machine learning model created by transferring the patterns of the weights, parameters, operational patterns, or Outputs of MiniMax-H3-Image or any Model Derivative thereof to another model, such that the latter model exhibits behavior similar to MiniMax-H3-Image or its Model Derivatives, including by distillation methods, methods using intermediate data representations, or methods based on training using synthetic-data Outputs generated by MiniMax-H3-Image or its Model Derivatives. For the avoidance of doubt, Outputs are not deemed Model Derivatives.
+12. “Output” means any result of operating or otherwise using MiniMax-H3-Image or any Model Derivatives (including through Hosted Service).
+13. “Third Party” means any natural or legal person that is not under common control with us or with you.
+14. “Including” means “including but not limited to.”
+15. “We,” “Us”  or  “MiniMax” means Nanonoble Pte. Ltd..
+II.  Grant of Rights
+Solely within the Applicable Territory, we grant you a non-exclusive, non-transferable, royalty-free, limited license to use, reproduce, distribute, create derivative works (including Model Derivatives), and modify the Materials in accordance with the terms of this Agreement and the Acceptable Use Policy, based on the intellectual property and other rights owned by MiniMax that are embodied in or used by the Materials. You shall not violate (or encourage or permit any person to violate) any term of this Agreement or the Acceptable Use Policy.
+We will continuously evaluate the applicable laws, regulations and compliance requirements for the Excluded Territories. In the meantime, should any person in such Excluded Territories be interested in deploying our models, you are welcome to contact us about obtaining a license, which will be granted based on robust controls and guardrails for purposes of complying with the laws, regulations and compliance requirements of the Excluded Territories.
+III.  Distribution and Redistribution
+Subject to and conditioned on your continuing compliance with this Agreement, including its territorial restrictions and the Acceptable Use Policy, and solely within the Applicable Territory, you may distribute or make available the MiniMax-H3-Image Works to Third Parties within the Applicable Territory; provided, that all of the following conditions are met:
+1. You must provide a copy of this Agreement to all such Third Parties who receive the MiniMax-H3-Image Works or use your products or services related thereto;
+2. You must cause any modified files to carry prominent notices stating that you have modified such files;
+3. You are encouraged to:
+  a. display a notice on any product or service developed using MiniMax-H3-Image indicating that the product or service is “Powered by MiniMax-H3-Image”; 
+  b. add an AI-generation identifier to files produced using generative AI models including MiniMax-H3-Image; and
+  c. publish at least one technical blog post or a public statement describing your experience using MiniMax-H3-Image Works;
+4. All distributions to Third Parties (other than through Hosted Service) must be accompanied by a “NOTICE” text file containing the following notice:
+  “MiniMax-H3-Image is licensed under the MiniMax-H3-Image Community License Agreement, Copyright © 2026 MiniMax. All Rights Reserved.”
+You may add your own copyright notices on your modifications; except as provided in this Section and in Section V, however, you may not impose additional or different terms and conditions on the use, reproduction, or distribution of your modifications or of any aggregate Model Derivatives, and your use, reproduction, modification, distribution, running, and display of the work must otherwise comply with the terms and conditions of this Agreement (including the provisions concerning the Applicable Territory). If you receive the MiniMax-H3-Image Works from a Licensee as part of an integrated end-user product, the provisions of Section III of this Agreement do not apply to you, but Section V and Exhibit A remain applicable.
+IV.  Additional Commercial Terms
+1. You shall obtain a separate, prior written authorization from MiniMax by sending a request through https://platform.minimax.io/license, if the Annualized Revenue of you and/or your affiliates exceeds 1 Million USD, or, you provide Hosted Service(s) to any Third Parties.
+2. You shall prominently display “MiniMax-H3-Image”on the user interface of commercial product or service that uses MiniMax-H3-Image or MiniMax-H3-Image Works.
+V. Use Restrictions
+1. Your use of the MiniMax-H3-Image Works must comply with applicable laws and regulations (including trade-compliance laws and regulations) and must comply with the Acceptable Use Policy for the MiniMax-H3-Image Works, which is incorporated into this Agreement by reference. 
+2. Before providing access to the MiniMax-H3-Image Works or any product, service, or Hosted Service incorporating them, you must bind each recipient or user to enforceable terms at least as protective as the use restrictions in this Section V and Exhibit A, and you must notify each recipient or user that those restrictions apply.
+3. You may not use the MiniMax-H3-Image Works or any of their Outputs or results to improve any other artificial intelligence model (other than MiniMax-H3-Image or its Model Derivatives).
+4. You may not use, reproduce, modify, distribute, or display the MiniMax-H3-Image Works or any of their Outputs or results outside the Applicable Territory. Any such use outside the Applicable Territory is not authorized by this Agreement.
+5. If you provide or make available to any Third Party a product, service, or Hosted Service that permits the generation of Outputs using MiniMax-H3-Image or any Model Derivative, you must, before making that product or service available and throughout its operation, implement, maintain, test, and periodically review reasonable and proportionate technical and organizational safeguards designed to prevent and mitigate access, uses, and Outputs that violate this Section V or Exhibit A, including uses or Outputs that infringe, misappropriate, or otherwise violate any Third Party’s intellectual-property or other rights. You must not knowingly disable, materially weaken, or permit the circumvention of those safeguards. You must maintain a reasonably accessible mechanism for reporting suspected violations. Upon receiving a good-faith report or otherwise obtaining actual knowledge of a violation, you must promptly investigate and take reasonable steps within your control to stop or mitigate the violation, including removing or disabling access to offending content or services and suspending or terminating repeat violators where appropriate. You are responsible for implementing and enforcing these requirements with respect to your products, services, systems, users, and downstream recipients.
+VI.  Intellectual Property
+1. Subject to MiniMax’s rights in the MiniMax-H3-Image Works (and the intellectual property therein), and to your compliance with the terms and conditions of this Agreement, as between you and MiniMax, you will own the derivative works and modifications of the Materials that you have created or had created, as well as any Model Derivatives.
+2. Except for the limited license expressly granted in this paragraph, no trademark license is granted under this Agreement; with respect to MiniMax-H3-Image Works, the Licensee may not use any name or mark owned by or associated with MiniMax or any of its affiliates, except as reasonably and customarily necessary to describe and distribute the MiniMax-H3-Image Works. MiniMax hereby grants you a license to use the “MiniMax-H3-Image” mark (the “Mark”) within the Applicable Territory solely for the purpose of complying with Section III.3; provided, that you comply with all applicable trademark-protection laws. All goodwill arising from your use of the Mark shall inure to the benefit of MiniMax.
+3. If you bring or assert any suit or other legal proceeding (including a cross-claim or counterclaim in any action) against us or any other natural or legal person alleging that the Materials, any Output, or any portion of the foregoing infringes any intellectual property right or other right owned by you or for which you can obtain a license, all licenses granted to you under this Agreement will terminate as of the date such suit or proceeding is filed. You shall defend, indemnify, and hold us harmless against any Third-Party claim arising out of or related to the use or distribution of the MiniMax-H3-Image Works by you or by any Third Party.
+4. MiniMax claims no rights over the Outputs you generate. You and your users are entirely responsible for the Outputs and any subsequent use thereof.
+VII.  Disclaimers and Limitations of Liability
+1. We have no obligation to support, update, provide training for, or develop any further version of the MiniMax-H3-Image Works, or to grant any license with respect thereto.
+2. UNLESS AND ONLY TO THE EXTENT REQUIRED BY APPLICABLE LAW, THE MiniMax-H3-Image WORKS AND ANY OUTPUT AND RESULTS THEREFROM ARE PROVIDED “AS IS” WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES OF ANY KIND INCLUDING ANY WARRANTIES OF TITLE, MERCHANTABILITY, NONINFRINGEMENT, COURSE OF DEALING, USAGE OF TRADE, OR FITNESS FOR A PARTICULAR PURPOSE. YOU ARE SOLELY RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OF USING, REPRODUCING, MODIFYING, PERFORMING, DISPLAYING OR DISTRIBUTING ANY OF THE MiniMax-H3-Image WORKS OR OUTPUTS AND ASSUME ANY AND ALL RISKS ASSOCIATED WITH YOUR OR A THIRD PARTY’S USE OR DISTRIBUTION OF ANY OF THE MiniMax-H3-Image WORKS OR OUTPUTS AND YOUR EXERCISE OF RIGHTS AND PERMISSIONS UNDER THIS AGREEMENT.
+3. TO THE FULLEST EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL MINIMAX OR ITS AFFILIATES BE LIABLE UNDER ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, TORT, NEGLIGENCE, PRODUCTS LIABILITY, OR OTHERWISE, FOR ANY DAMAGES, INCLUDING ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, EXEMPLARY, CONSEQUENTIAL OR PUNITIVE DAMAGES, OR LOST PROFITS OF ANY KIND ARISING FROM THIS AGREEMENT OR RELATED TO ANY OF THE MiniMax-H3-Image WORKS OR OUTPUTS, EVEN IF MINIMAX OR ITS AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF ANY OF THE FOREGOING.
+VIII.  Term and Termination
+1. This Agreement is effective from the moment you accept this Agreement or begin accessing the Materials, and, subject to your compliance with its terms and conditions, will remain in effect until terminated as provided herein.
+2. If you breach any term or condition of this Agreement, we have the right to terminate this Agreement. Upon termination, you must immediately cease accessing, using, and distributing the MiniMax-H3-Image Works; delete or destroy all copies within your possession or control; and notify each downstream recipient that your authorization has ended. The obligations in the preceding sentence and Sections VI.1, VI.3, VII, and IX survive termination.
+IX.  Governing Law and Jurisdiction
+1. This Agreement, and any dispute arising out of or related to this Agreement, shall be governed by the laws of the Hong Kong Special Administrative Region of the People’s Republic of China, without regard to its conflict-of-laws rules. The United Nations Convention on Contracts for the International Sale of Goods does not apply to this Agreement.
+2. Any dispute arising out of or related to this Agreement shall be subject to the exclusive jurisdiction of the courts of the Hong Kong Special Administrative Region of the People’s Republic of China with competent jurisdiction. Both MiniMax and the Licensee hereby consent to the exclusive jurisdiction of such courts for any such dispute.
+Additional Note: Please note that the text-to-image prompt enhancer model (https://huggingface.co/MiniMaxAI/MiniMax-H3-Image-PE, "T2I PE Model") of MiniMax-H3-Image is derived from Qwen3.8-27B licensed under Apache 2.0 License: https://huggingface.co/Qwen/Qwen3.8-27B. The T2I PE Model is part of MiniMax-H3-Image and is accordingly subject to this Agreement for the avoidance of doubt.
+
+Exhibit A — Acceptable Use Policy
+MiniMax reserves the right to update this Acceptable Use Policy from time to time. 
+Last revised: November 10, 2026.
+MiniMax is committed to promoting the safe and fair use of its tools and features, including MiniMax-H3-Image. You agree not to use MiniMax-H3-Image, any Model Derivatives, or any Output in any of the following ways:
+1. Use outside the Applicable Territory;
+2. Use in any manner that violates any applicable national, federal, state, local, or international law, regulation, or other legal requirement, or that infringes, misappropriates, or otherwise violates any Third Party’s intellectual-property or other proprietary rights, including through unauthorized reproduction, distribution, public display, public performance, or creation of derivative works;
+3. Use in any manner that may harm yourself or others;
+4. Use to repurpose or distribute the Outputs of MiniMax-H3-Image or any Model Derivatives in order to harm yourself or others;
+5. Use to circumvent or bypass any safety guardrails or safeguards we have implemented;
+6. Use in any manner that exploits or harms, or intends to exploit or harm, minors;
+7. Use to generate or disseminate verifiably false information and/or content for the purpose of harming others or influencing elections;
+8. Use to manufacture or facilitate false online engagement, including fake reviews and other means of false online engagement;
+9. Use to intentionally defame, disparage, or otherwise harass others;
+10. Use to generate and/or disseminate malware (including ransomware) or any other content intended to damage electronic systems;
+11. Use to generate or disseminate personally identifiable information for the purpose of harming others;
+12. Use to generate or disseminate information (including images, code, posts, or articles) in or to any public environment (including via bot tweets or similar means) without clearly and prominently disclosing that such information and/or content is machine-generated;
+13. Use to impersonate another person without that person’s consent, authorization, or lawful right to do so;
+14. Use to make high-risk automated decisions in critical domains that affect individual safety, rights, or well-being (such as law enforcement, immigration, healthcare or medical services, critical-infrastructure management, product-safety components, essential services, credit, employment, housing, education, social scoring, or insurance);
+15. Use in any manner that violates or disregards the social, ethical, or moral standards of other countries or regions;
+16. Use to carry out, assist, threaten, incite, plan, advocate for, or encourage violent extremism or terrorism;
+17. Use for any purpose intended to discriminate against, or harm, individuals or groups based on protected characteristics or categories, online or offline social behavior, or known or predicted personality traits;
+18. Use to intentionally exploit the vulnerabilities of specific populations based on age, social, physical, or psychological characteristics, so as to materially distort the behavior of a member of that group in a manner that causes, or is likely to cause, physical or psychological harm to that person or to others;
+19. Use for military purposes;
+20. Use to engage in any unauthorized or unlicensed professional activity, including but not limited to financial, legal, medical or healthcare, or other professional practice.

h3_image_mlx-0.1.0a1/src/h3_image_mlx/NOTICE.txt

@@ -0,0 +1,7 @@
+MiniMax-H3-Image is licensed under the MiniMax-H3-Image Community License Agreement, Copyright © 2026 MiniMax. All Rights Reserved.
+Weights: MiniMaxAI/MiniMax-H3-Image, repackaged and quantized by Comfy-Org.
+See MODEL_LICENSE.txt for the upstream model license. Model weights and the VAE configuration are downloaded separately.
+The implementation authored for this project is licensed under Apache-2.0.
+This implementation adapts H3 Image inference to Apple MLX, including staged memory management and ConvRot projections.
+The three Metal kernel source files are from ddalcu/mlx-serve commit 9191fbdf697df333cac19ec7a93eaa1098ce3ad5.
+Their copyright and MIT license are in kernels/LICENSE.

h3_image_mlx-0.1.0a1/src/h3_image_mlx/__init__.py

@@ -0,0 +1,4 @@
+"""Local H3 Image inference on Apple Silicon."""
+from .pipeline import generate
+
+__all__ = ["generate"]

h3_image_mlx-0.1.0a1/src/h3_image_mlx/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

h3_image_mlx-0.1.0a1/src/h3_image_mlx/_portable.py

@@ -0,0 +1,41 @@
+"""Evaluate H3's quantized projections with standard MLX operations."""
+
+import mlx.core as mx
+
+# An int8 dot product of length 1024 has an absolute sum <= 2**24, so its
+# integer partial sums are exactly representable in float32. H3's longest
+# projection has K=25600, safely within int32 for the combined sum.
+_DOT_CHUNK = 1024
+_TILE = 1024
+
+
+def portable_matmul(xq, weight, xs, scale, output_dtype):
+    """Compute row-scaled int8 dot products without the M5 Metal TensorOps kernel."""
+    rows, width = xq.shape
+    channels = weight.shape[0]
+    row_scale = xs.reshape(rows, 1).astype(mx.float32)
+    channel_scale = mx.broadcast_to(scale.reshape(-1), (channels,)).astype(mx.float32)
+
+    row_tiles = []
+    for r in range(0, rows, _TILE):
+        columns = []
+        row_slice = slice(r, r + _TILE)
+        for c in range(0, channels, _TILE):
+            col_slice = slice(c, c + _TILE)
+            total = None
+            for k in range(0, width, _DOT_CHUNK):
+                inner = slice(k, k + _DOT_CHUNK)
+                a = xq[row_slice, inner].astype(mx.float32)
+                b = weight[col_slice, inner].astype(mx.float32)
+                partial = (a @ b.T).astype(mx.int32)
+                total = partial if total is None else total + partial
+            # Evaluate before advancing to the next tile: no dense floating
+            # point copy of an entire large weight is retained across tiles.
+            y = total.astype(mx.float32) * row_scale[row_slice] * channel_scale[col_slice]
+            y = y.astype(output_dtype)
+            mx.eval(y)
+            columns.append(y)
+        row = mx.concatenate(columns, axis=1) if len(columns) > 1 else columns[0]
+        mx.eval(row)
+        row_tiles.append(row)
+    return mx.concatenate(row_tiles, axis=0) if len(row_tiles) > 1 else row_tiles[0]

h3_image_mlx-0.1.0a1/src/h3_image_mlx/_stage.py

@@ -0,0 +1,64 @@
+"""Private stage entry point. Each child releases its weights on exit."""
+import json
+import re
+import sys
+from pathlib import Path
+from .models import DIT, TEXT, TOKENIZER, VAE, VAE_CONFIG
+
+
+def select_backend(requested, device):
+    native = bool(re.search(r"\bApple M[56]\b", device))
+    if requested == "auto":
+        return "w8a8" if native else "portable"
+    if requested == "w8a8" and not native:
+        raise ValueError(f"The W8A8 TensorOps kernel requires an M5/M6 GPU; found {device}")
+    return requested
+
+
+def main(stage, work):
+    import mlx.core as mx
+    from . import core
+    request = json.loads((work / "request.json").read_text())
+    info = mx.device_info()
+    backend = select_backend(request["backend"], info["device_name"])
+    core.backend.set(backend)
+    mx.set_cache_limit(96 << 20)
+    models = Path(request["models"])
+    refs = request["references"]
+    embedding, latents, result = (str(work / (key + ".safetensors")) for key in ("embedding", "references", "latent"))
+    if stage == "text":
+        from .text import encode
+        x, tags, _ = encode(models / TEXT, models / TOKENIZER, request["prompt"], refs)
+        mx.save_safetensors(embedding, {"embedding": x, "tags": tags})
+    elif stage == "references":
+        from .ref_vae import encode_reference
+        weights = core.Weights(models / VAE, True)
+        stats = json.loads((models / VAE_CONFIG).read_text())
+        zs = {}
+        for i, ref in enumerate(refs):
+            zs[str(i)] = encode_reference(weights, ref, stats)
+            mx.eval(zs[str(i)])
+        mx.save_safetensors(latents, zs)
+    elif stage == "dit":
+        from .dit import denoise
+        inputs = mx.load(embedding)
+        images = mx.load(latents) if refs else {}
+        zs = [images[str(i)] for i in range(len(refs))]
+        width, height = request["width"], request["height"]
+        rows = inputs["embedding"].shape[0] + width * height // 1024 + sum(z.shape[1] * z.shape[2] // 4 for z in zs)
+        mode = request["dit_mode"]
+        resident = mode == "resident" or (mode == "auto" and backend == "w8a8" and
+                    info["memory_size"] >= 32 * 1024**3 and rows <= 8192)
+        z, _ = denoise(models / DIT, inputs["embedding"], width, height, request["seed"], resident, zs, inputs["tags"])
+        mx.save_safetensors(result, {"latent": z})
+    elif stage == "vae":
+        from .vae import decode
+        stats = json.loads((models / VAE_CONFIG).read_text())
+        decode(models / VAE, mx.load(result)["latent"], stats).save(work / "image.png")
+    else:
+        raise ValueError(f"Unknown stage: {stage}")
+    mx.synchronize()
+
+
+if __name__ == "__main__":
+    main(sys.argv[1], Path(sys.argv[2]))