Release v0.4.0: selective MLX model downloads

.gitignore

@@ -0,0 +1,14 @@
+.venv/
+.venv-coreml/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+build/
+dist/
+*.egg-info/
+.DS_Store
+models/
+cache/
+outputs/
+*.metaltrace
+.release/

BENCHMARKS.md

@@ -0,0 +1,47 @@
+# Measurements and their scope
+
+These are recorded local measurements, not a comparison with CUDA or a
+promise for another Mac. Test machine: **Apple M5 Pro, 16 GPU cores, 64 GiB,
+macOS 27.0.1, MLX 0.32.4**. The default retains BF16 transformer weights,
+FP32 precision islands, dense attention, all six PDD heads and BF16 VAE
+arithmetic following the inspected source path.
+
+| Storage | Paired warm control | Tuned warm latency | Reduction | Maximum sampled parent footprint across four candidate cases |
+|---|---:|---:|---:|---:|
+| Dense BF16 | 65.83 s | 62.49 s | 5.07% | 40.50 GiB |
+| Lossless packed BF16 | 66.42 s | 64.05 s | 3.57% | 32.56 GiB |
+
+Latencies are equal-weight geometric means of product and portrait medians,
+three alternating paired repeats per case, 2048 × 2048. Conditioning is cached
+and model weights are resident. Trace and PNG save are included; interpreter
+startup, downloads and external image scoring are excluded. First-load runs
+are retained separately. Each storage mode has its own paired campaign:
+these numbers do not isolate the speed effect of compression.
+
+The four quality cases include product, portrait, fine detail and one
+reference-image edit. Within the recorded exact-tuning campaigns, every
+output pixel and saved denoising tensor agrees with its matched control.
+This establishes agreement with the stated MLX reference on these cases,
+not CUDA byte identity, ground-truth image quality or general superiority.
+
+Physical footprint is sampled every 100 ms for the parent process and can
+miss short peaks. It includes Metal, excludes compiler XPC services, and is
+different from MLX allocator counters. Do not add overlapping counters. These
+measurements do not establish a minimum supported Mac memory capacity.
+
+**Q8/Q4 change images.** Historical trials include lettering and detail drift;
+quantization was sometimes slower at real token counts. No speed claim or
+quality ranking is made for the new downloadable packaging. Fewer-step
+previews and the experimental Core ML/ANE decoder are not model variants in
+this release. ANE decoder artifacts are documented, not promoted as a feature.
+
+- [Full exact-tuning report](reports/optimization-r3/RESULTS.md)
+- [Dense receipt and pixel/tensor audit](reports/optimization-r3/qk-deployment/quality-audit.json)
+- [Packed receipt and audit](reports/optimization-r3/compact-deployment/quality-audit.json)
+- [Historical precision and backend comparisons](reports/optimization-v2/RESULTS.md)
+- [Native / Q8 / Q4 image comparison](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product/stack.png)
+- [Fresh release validation](docs/VALIDATION.md)
+
+The provenance files pin upstream sources and record the inspected source
+hashes. Packaging tests and fresh portable-weight inference are reported
+separately from historical performance measurements.

LICENSE

@@ -0,0 +1,201 @@
+                                 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 2023-2024 SGLang Team
+
+   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.

LICENSE-model

@@ -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.

LICENSE-text-encoder

@@ -0,0 +1,84 @@
+MiniMax H3 COMMUNITY LICENSE AGREEMENT
+MiniMax H3 release date/License date: August 2, 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 Works (including through any Hosted Services) 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 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 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” means the video generation model, together with its software and algorithms, including trained model weights, parameters (including optimizer states), machine-learning model code, inference-supporting code, and other elements thereof made publicly available by Us, as released at https://huggingface.co/MiniMaxAI/MiniMax-H3.
+7. “MiniMax H3 Works” means (i) the Materials, (ii) the Model Derivatives, and (iii) all derivatives thereof.
+8. “Hosted Services” means hosted services provided 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 Works for any purpose in any field of use under this Agreement.
+10. “Materials” means, collectively, MiniMax H3 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 or any Model Derivative thereof; (ii) any work based on MiniMax H3 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 or any Model Derivative thereof to another model, such that the latter model exhibits behavior similar to MiniMax H3 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 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 or any Model Derivatives (including through Hosted Services).
+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 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 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 indicating that the product or service is “Powered by MiniMax H3”; 
+  b. add an AI-generation identifier to files produced using generative AI models including MiniMax H3; and
+  c. publish at least one technical blog post or a public statement describing your experience using MiniMax H3 Works;
+4. All distributions to Third Parties (other than through Hosted Services) must be accompanied by a “NOTICE” text file containing the following notice:
+  “MiniMax H3 is licensed under the MiniMax H3 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 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 contacting api@minimax.io with the subject line “MiniMax H3 licensing - authorization request”, if your commercial products and services generate more than 20 million US dollars (or equivalent in other currencies) in yearly revenue.
+2. You shall prominently display “MiniMax H3”on the user interface of commercial product or service that uses MiniMax H3 or MiniMax H3 Works.
+V. Use Restrictions
+1. Your use of the MiniMax H3 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 Works, which is incorporated into this Agreement by reference. 
+2. Before providing access to the MiniMax H3 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 Works or any of their Outputs or results to improve any other artificial intelligence model (other than MiniMax H3 or its Model Derivatives).
+4. You may not use, reproduce, modify, distribute, or display the MiniMax H3 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 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 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 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 Works. MiniMax hereby grants you a license to use the “MiniMax H3” 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 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 Works, or to grant any license with respect thereto.
+2. UNLESS AND ONLY TO THE EXTENT REQUIRED BY APPLICABLE LAW, THE MINIMAX H3 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 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 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 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 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 encoder of MiniMax H3 uses Qwen3-VL-32B, which is licensed under Apache 2.0 License: https://github.com/QwenLM/Qwen3-VL/blob/main/LICENSE.
+
+Exhibit A — Acceptable Use Policy
+MiniMax reserves the right to update this Acceptable Use Policy from time to time. 
+Last revised: August 2, 2026.
+MiniMax is committed to promoting the safe and fair use of its tools and features, including MiniMax H3. You agree not to use MiniMax H3, 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 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.

MODEL_INDEX.md

@@ -0,0 +1,51 @@
+# Model and repository index
+
+The Hugging Face Hub uses sibling repositories grouped by a collection.
+The main repository links them; it does not contain nested Git repositories
+or any model weights. Each download selects one variant and shared components.
+
+| Repository under `devin-lai/` | Contents | Selection |
+|---|---|---|
+| `MiniMax-H3-Image-mlx` | Inference source, documentation, tests and comparison records | Install once |
+| `MiniMax-H3-Image-mlx-packed12` | Fifty losslessly packed main DiT blocks | Recommended exact storage choice |
+| `MiniMax-H3-Image-mlx-bf16` | Original complete BF16/FP32 transformer | Unmodified storage control |
+| `MiniMax-H3-Image-mlx-q8` | Q8 main blocks and token refiners, group 64 | Smaller weights, image changes |
+| `MiniMax-H3-Image-mlx-q4` | Q4 main blocks and token refiners, group 64 | Smallest core, larger image changes |
+| `MiniMax-H3-Image-mlx-shared` | VAE, PDD heads, native support, configs and modulation tables | Fetched as needed, reused across variants |
+| `MiniMax-H3-Image-mlx-examples` | Generated images and visual comparisons | Optional gallery, with manual access review |
+
+The unchanged encoder is fetched from
+[`MiniMaxAI/MiniMax-H3`](https://huggingface.co/MiniMaxAI/MiniMax-H3/tree/0919fb684102ef115126612f3fbb84d1027e7317/text_encoder)
+at revision `0919fb684102ef115126612f3fbb84d1027e7317`. Only its `text_encoder/`
+directory and license are selected. This is about **62.14 GiB** of weights and
+tokenizer files; it is a substantial first download. An existing copy can be
+reused with `--text-encoder-path`.
+
+The image source is `MiniMaxAI/MiniMax-H3-Image` at revision
+`6534ea1c979a5f8cb00c2bd1025d5ca4ee8d8901`. All uploaded model files receive
+SHA-256 manifests; the runtime catalog pins each component repository to a
+full commit ID. A `v0.4.0` tag provides a human-readable
+release name. Runtime options such as compiled execution, VAE tile batches
+and reduced steps do not create additional model repositories.
+
+## Layout after downloading
+
+```text
+models/packed12/
+  release.json
+  transformer/             # Native constants, norms, refiners and config
+  core/                    # Only the chosen variant
+  modulation/              # Six-step generation and editing tables
+  vae/
+  pdd_config.json
+  pdd_fused_heads.safetensors
+  text_encoder/            # Link to the one shared upstream cache
+  licenses/
+```
+
+Files are linked to Hugging Face's cache rather than copied. Keep that cache
+while using the assembled directory. `--local-files-only` supports cached,
+offline assembly. `--verify` rehashes all selected image-model files; the
+encoder download uses the Hub's pinned, content-addressed download mechanism.
+Download size is different from runtime memory. The prepared release's exact
+file sizes are recorded in each repository's `files.json` manifest.

NOTICE

@@ -0,0 +1,15 @@
+MiniMax-H3-Image-mlx
+Copyright 2026 MiniMax-H3-Image-mlx contributors
+
+MiniMax-H3-Image is licensed under the MiniMax-H3-Image Community License
+Agreement, Copyright © 2026 MiniMax. All Rights Reserved.
+
+The model architecture and inference contracts were ported from SGLang's
+Apache-2.0 MiniMax H3 implementation and Hugging Face Transformers' Apache-2.0
+Qwen3-VL implementation. Source identities and file digests are recorded in
+provenance/sources.json. See LICENSE for the code license.
+
+Model weights are NOT covered by this repository's Apache-2.0 code license.
+MiniMax-H3-Image weights remain subject to the MiniMax-H3-Image Community
+License Agreement; the separate MiniMax-H3 text encoder retains its own terms.
+No model weights are included in this repository.

README.md

@@ -0,0 +1,156 @@
+---
+library_name: mlx
+pipeline_tag: text-to-image
+license: other
+license_name: minimax-h3-image-community-license-agreement
+license_link: https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/blob/v0.4.0/LICENSE-model
+base_model: MiniMaxAI/MiniMax-H3-Image
+language:
+  - en
+tags:
+  - mlx
+  - apple-silicon
+  - macos
+  - minimax-h3
+  - text-to-image
+  - image-to-image
+  - image-editing
+  - image-generation
+  - safetensors
+inference: false
+---
+
+# MiniMax H3 Image on Apple silicon
+
+**Generate and edit images locally with MLX. Choose one weight variant; reuse the shared components.**
+
+[View the generated showcase and comparisons](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples)
+
+*The gallery contains AI-generated images from recorded local runs. It uses
+manual access review under the model license. [Prompts, seeds and precision
+settings](examples/README.md) are also documented here.*
+
+A community port of [MiniMax-H3-Image](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image)
+by [Devin Lai](https://huggingface.co/devin-lai). Native MLX/Metal inference,
+all six distilled PDD steps, reference-image editing, lossless BF16 packing
+and optional Q8/Q4 weights. Model operators run locally on your Mac.
+
+[Quick start](#quick-start) · [Choose weights](#choose-your-download) ·
+[Usage](USAGE.md) · [Benchmarks](BENCHMARKS.md) ·
+[Collection](https://huggingface.co/collections/devin-lai/minimax-h3-image-apple-silicon-mlx-6af64fcd11d7d7a3b17e11d8) · [Repository map](MODEL_INDEX.md) · [简体中文](README.zh-CN.md)
+
+**Start with packed12 on a sufficiently large Mac.** It reconstructs the
+original BF16 weight bits before computation. It is storage compression,
+not quantization. The tested machine is an **M5 Pro with 64 GiB**;
+smaller-memory Macs have not been qualified.
+
+## Choose your download
+
+The main repository contains inference code, documentation and comparison
+records. Generated images are in the separately gated example gallery. Each
+linked model repository contains one weight choice.
+The downloader fetches that choice and its required shared files, then reuses
+the same pinned upstream text encoder across variants.
+
+| Variant | Variant weights¹ | Choose it for |
+|---|---:|---|
+| **[Lossless packed BF16](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-packed12)** | **27.23 GiB** | Recommended exact storage choice; original BF16 payloads |
+| [Original BF16](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-bf16) | 61.73 GiB | Unmodified complete transformer storage |
+| [Q8](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-q8) | 19.83 GiB | Smaller core; image and detail changes |
+| [Q4](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-q4) | 10.50 GiB | Smallest core; stronger fidelity tradeoffs |
+
+¹ Excludes [shared VAE, support tensors, heads and tables](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-shared),
+the separate **roughly 62 GiB text encoder**, Python dependencies and runtime
+memory. BF16 already includes native support; the downloader omits its redundant
+shared copy.
+Download sizes are not RAM requirements. Q8/Q4 quantize main and refiner
+attention/MLP weights with MLX affine groups of 64; FP32 precision islands stay
+native. Quantization has not established a generation-speed advantage here.
+
+**License and access:** model weights retain MiniMax's community agreements,
+including territory and commercial restrictions; they are not unrestricted
+open-source weights. Model components use manual access review.
+[Status and license details](RELEASE.md).
+
+## Quick start
+
+Use an Apple silicon Mac, native arm64 Python 3.12 and
+[uv](https://docs.astral.sh/uv/getting-started/installation/). Request access
+on the selected model and shared-component pages before downloading weights:
+
+```bash
+uv venv --python 3.12 .venv
+source .venv/bin/activate
+uv pip install huggingface-hub==0.36.2
+hf auth login
+
+hf download devin-lai/MiniMax-H3-Image-mlx --revision v0.4.0 \
+  --include 'h3_mlx/*' pyproject.toml LICENSE NOTICE \
+  --local-dir h3-runtime
+uv pip install './h3-runtime[native]'
+h3-mlx doctor
+
+h3-mlx download --variant packed12 --model-dir models/packed12
+h3-mlx generate --model models/packed12 \
+  --text-encoder models/packed12/text_encoder \
+  'An editorial photograph of a cobalt perfume bottle on pale stone' \
+  --width 2048 --height 2048 --seed 731 --output outputs/bottle.png
+```
+
+The first download is large because the native text encoder is separate.
+Reuse an existing encoder with `--text-encoder-path /path/to/text_encoder`.
+Use `--variant q8`, `q4` or `bf16` to select another weight repository.
+Each output includes a JSON record with the prompt, seed, schedule, hardware,
+precision, timings and memory. [Offline use, tuning and Python API](USAGE.md).
+
+For reference-image editing, add `--image bottle.png` and describe the edit
+using `<Picture 1>`. The implementation accepts up to sixteen ordered inputs;
+the recorded edit cohort validates one reference. Detailed English prompts are
+recommended; the runtime does not silently expand them.
+
+## Measured on M5 Pro / 64 GiB
+
+The selected exact tuning measured **62.49 s dense / 64.05 s packed** for warm
+2048-square generation, with maximum sampled parent footprints of **40.50 /
+32.56 GiB** across four candidate cases. Each mode improved against its own
+paired MLX control: **5.07% / 3.57%**. Every pixel and saved denoising tensor
+matched the corresponding control in the recorded four-case suites.
+
+These are historical local campaigns with cached conditioning and resident
+weights, three alternating repeats per timing case. They exclude startup and
+downloads. They do not establish CUDA pixel identity, a minimum RAM capacity,
+new packaging performance or a universal speed guarantee.
+[Method, ranges, raw receipts and limitations](BENCHMARKS.md).
+
+## Inspect, reproduce, contribute
+
+- [Original examples and provenance](examples/README.md): authentic outputs,
+  prompts, seeds and reference images, clearly identified as AI-generated.
+- [Native / Q8 / Q4 comparisons](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product/stack.png): inspect the
+  lettering and detail changes before choosing compact weights.
+- [Technical guide](docs/TECHNICAL.md): precision rules, resident Python
+  pipelines, reference-image processing and experiment reproduction.
+- [Validation](docs/VALIDATION.md): release software checks and fresh inference.
+- [Community discussions](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/discussions):
+  share a reproducible issue or result with your variant, prompt, seed, canvas,
+  Mac configuration and generated JSON record.
+
+If the project helps you, like the variant you use and
+[follow devin-lai](https://huggingface.co/devin-lai) for future Mac releases.
+Measured contributions and examples from more Apple silicon configurations
+are welcome. No hosted inference service is bundled.
+
+## Attribution and terms
+
+Independent community MLX adaptation by Devin Lai, based on MiniMax's released
+weights and the inspected SGLang/Transformers inference contracts. This is not
+an official MiniMax release or endorsement. Powered by MiniMax-H3-Image.
+
+**Runtime code:** [Apache-2.0](LICENSE).
+**Image weights and derivatives:** [MiniMax-H3-Image Community License Agreement](LICENSE-model).
+**Separate text encoder:** [MiniMax H3 Community License Agreement](LICENSE-text-encoder).
+The published agreements exclude the EU, UK, Republic of Korea and US absent
+separate permission and include commercial, redistribution and acceptable-use
+conditions. Access review does not grant additional rights.
+[Modifications](docs/MODIFICATIONS.md) · [NOTICE](NOTICE) ·
+[Pinned source provenance](provenance/sources.json).

README.zh-CN.md

@@ -0,0 +1,38 @@
+# MiniMax H3 Image · Apple 芯片 / MLX
+
+在 Mac 上通过 MLX/Metal 本地生成和编辑图像。由 Devin Lai 维护的社区移植，
+保留原始六步 PDD 调度、BF16 权重与 FP32 精度敏感层，提供无损 packed12、
+原始 BF16，以及有损 Q8/Q4 选项。
+
+[查看 AI 生成的示例与对比图（需申请访问）](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples)
+
+主仓库存放运行代码、文档和可选的对比证据。模型权重按变体放在独立仓库；
+只下载所选变体，复用 VAE 等公共组件和固定版本的官方文本编码器。
+文本编码器约 62 GiB，首次下载量较大，也可以复用已有文件。
+
+建议首先选择 **packed12**：这是 BF16 位级无损存储压缩，不是 12 位量化。
+Q8/Q4 会改变生成结果，并不保证速度更快。测试设备是 **M5 Pro / 64 GiB**；
+尚未确认更小内存设备的最低配置。历史 2048×2048 热运行实测约 62–64 秒，
+不含下载和进程启动，详情见[基准说明](BENCHMARKS.md)。
+
+安装运行环境并获得所需访问权限后可使用：
+
+```bash
+h3-mlx download --variant packed12 --model-dir models/packed12
+h3-mlx generate --model models/packed12 \
+  --text-encoder models/packed12/text_encoder \
+  'An editorial photograph of a cobalt perfume bottle on pale stone' \
+  --seed 731 --output outputs/bottle.png
+```
+
+[安装与使用](USAGE.md) · [模型选择](MODEL_INDEX.md) ·
+[原始输出与提示词](examples/README.md) · [English](README.md)
+
+**发布版本：v0.4.0，模型组件采用人工审核访问。** 模型并非无限制开源许可。
+图像权重及其衍生物保留 MiniMax-H3-Image 社区许可；文本编码器保留其独立许可。
+现行协议对欧盟、英国、韩国和美国有地域限制，并包含商业使用、再分发和可接受使用条件。
+使用前请确认具备所需权限。[发布与许可说明](RELEASE.md)。
+
+如项目有帮助，欢迎在 Hugging Face 点赞所用模型、关注
+[devin-lai](https://huggingface.co/devin-lai)，并分享附有设备、变体、提示词、
+seed 和生成 JSON 记录的可复现结果。

RELEASE.md

@@ -0,0 +1,47 @@
+# Release v0.4.0
+
+The main repository contains the MLX runtime, documentation, tests and
+comparison records. Model files are split across four variant repositories and
+a shared-components repository. Choose one variant; the downloader reuses the
+shared components and the separately pinned upstream text encoder. Generated
+images and visual comparisons are in a separate, manually gated example gallery.
+
+[Browse the collection](https://huggingface.co/collections/devin-lai/minimax-h3-image-apple-silicon-mlx-6af64fcd11d7d7a3b17e11d8).
+
+The component repositories use manual access review. Request access to your
+chosen variant and the shared repository, read the applicable licenses and
+sign in with `hf auth login`. Repository access does not itself grant rights
+outside the upstream licenses. The agreements include territorial, commercial,
+redistribution and acceptable-use conditions; their standard grant excludes the
+EU, UK, Republic of Korea and US. The code is Apache-2.0; model weights retain
+their respective MiniMax community licenses. No hosted inference service is
+included.
+
+[Quick start](README.md#quick-start) · [Model index](MODEL_INDEX.md) ·
+[Usage](USAGE.md) · [Validation](docs/VALIDATION.md)
+
+## Revisions and validation
+
+`h3_mlx/model_index.json` pins the shared and variant repositories to immutable
+commits. Each model repository also has a `v0.4.0` tag and a `files.json`
+manifest with byte sizes and SHA-256 hashes. The uploaded component files were
+checked against those manifests. The release validation records 53 local tests
+and full-image packaging reproductions for packed12 and Q4; it does not claim
+a fresh full-image Q8 reproduction or validation on another machine.
+
+## Preparing artifacts
+
+For maintainers with the original model and the validated packed cache:
+
+```bash
+python scripts/prepare_hf_release.py \
+  --model /path/to/MiniMax-H3-Image \
+  --packed-cache /path/to/validated/packed12-cache --quantize q4
+```
+
+Staging is written under `.release/huggingface/`. Existing model and packed
+files are linked rather than copied; optional quantized variants require
+additional scratch space. Preserve original checkpoints and caches. The
+publisher script uploads and verifies individual components before finalizing
+the pinned catalog. It does not automatically approve access requests or post
+announcements.

USAGE.md

@@ -0,0 +1,102 @@
+# Install and use
+
+Use Apple silicon, native arm64 Python 3.12, and a compatible macOS Metal
+installation. The measured environment is M5 Pro / 64 GiB, macOS 27.0.1,
+MLX 0.32.4 and Transformers 4.57.6. Smaller Macs have not been qualified.
+
+## Release installation
+
+Request access on the selected variant and shared model pages and read their
+licenses. Install [uv](https://docs.astral.sh/uv/getting-started/installation/)
+and authenticate with Hugging Face as shown below.
+
+```bash
+uv venv --python 3.12 .venv
+source .venv/bin/activate
+uv pip install huggingface-hub==0.36.2
+hf auth login
+hf download devin-lai/MiniMax-H3-Image-mlx --revision v0.4.0 \
+  --include 'h3_mlx/*' pyproject.toml LICENSE NOTICE \
+  --local-dir h3-runtime
+uv pip install './h3-runtime[native]'
+h3-mlx doctor
+
+h3-mlx download --variant packed12 --model-dir models/packed12
+h3-mlx generate --model models/packed12 \
+  --text-encoder models/packed12/text_encoder \
+  'An editorial photograph of a cobalt perfume bottle on pale stone' \
+  --width 2048 --height 2048 --seed 731 --output outputs/bottle.png
+```
+
+The release catalog records immutable component revisions. It rejects
+unpublished or unpinned weights. For local development use `uv pip install
+-e '.[native]'` and the original checkpoint paths, as in
+[the technical guide](docs/TECHNICAL.md).
+
+The `native` extra supplies PyTorch for the original CPU noise stream. Model
+operators still run in MLX on Metal. Without that extra, `--rng mlx` uses a
+different random stream and does not reproduce the same seeded images.
+
+## Select another variant or reuse existing weights
+
+```bash
+h3-mlx download --variant q8 --model-dir models/q8 \
+  --text-encoder-path /path/to/MiniMax-H3/text_encoder
+h3-mlx generate --model models/q8 --text-encoder models/q8/text_encoder \
+  'A detailed scene description' --output outputs/q8.png
+```
+
+Use `q4`, `bf16` or `packed12` in the same way. Use a separate assembly
+directory for each variant. Shared files and the encoder are cached once;
+no other variant is fetched. The release selects quantization automatically,
+so do not add `--quantize` or `--quantized-core` to published variants.
+
+To fetch the image model without the encoder, use `--skip-text-encoder` and
+pass your encoder path directly to generation. `--local-files-only` avoids
+network access when all required files already exist in the Hub cache.
+
+## Measured exact tuning
+
+On the tested M5 Pro / 64 GiB, add:
+
+```bash
+--compile-blocks --eval-every 0 --prefetch-blocks 4 \
+--compile-vae --vae-batch 4 --kernel metal-qk-exact --tune-matmul
+```
+
+Optional `--wired-gb 32` (packed12) or `--wired-gb 42` (BF16) were tested on
+this 64 GiB Mac. The runtime checks Metal's limit. They are not universal
+settings for other machines. Q8/Q4 are storage and memory tradeoffs and have
+not established a generation-speed advantage. Frozen modulation tables
+require MLX 0.32.4 and `MLX_ENABLE_TF32=0`; original checkpoints remain an
+alternative when regenerating tables in another supported environment.
+
+## Reference-image editing
+
+```bash
+h3-mlx generate --model models/packed12 \
+  --text-encoder models/packed12/text_encoder \
+  'Change the bottle in <Picture 1> to emerald glass while preserving its label' \
+  --image bottle.png --seed 42 --output outputs/edit.png
+```
+
+The implementation accepts up to sixteen ordered references. The recorded
+image-edit cohort covers one reference. This does not establish quality for
+every multi-image composition. Use detailed English prompts. Prompt expansion
+is not automatic. The default 2048-square canvas is within the model's usual
+4–20 MP working range. Smaller requested images are generated on an enlarged
+canvas and resized; development overrides are documented in the technical guide.
+
+Each output has a JSON record with precision, seeds, schedule, timings,
+memory and environment. Add `--save-trace` for numerical audits. Report issues
+with that record, your command, chip, memory, macOS and package versions.
+
+## Licenses and access
+
+The image weights and derivatives retain the MiniMax-H3-Image Community
+License Agreement, including its territory, commercial, redistribution and
+acceptable-use conditions. The text encoder has its own MiniMax H3 agreement.
+The published agreements exclude the EU, UK, Republic of Korea and US absent
+separate permission. A manual Hub gate supports access review; it does not
+grant rights outside those agreements. See `LICENSE-model`,
+`LICENSE-text-encoder`, `NOTICE` and [release status](RELEASE.md).

comparisons/README.md

@@ -0,0 +1,32 @@
+# Image comparison gallery
+
+All comparison pictures are actual recorded inference outputs. Each stack
+contains labeled full frames, identical 1:1 crops and absolute RGB differences
+amplified eight times. Metrics apply to full-resolution images, not previews.
+
+| Comparison | Viewer | Image stack | Native detail crops |
+|---|---|---|---|
+| 2K product: BF16 tuning, Q8, Q4, three-pass preview | [Open](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product/index.html) | [Frames](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product/stack.png) | [Details](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product/details.png) |
+| 2K portrait: native BF16 vs Q8 | [Open](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/portrait/index.html) | [Frames](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/portrait/stack.png) | [Details](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/portrait/details.png) |
+| Same final latent: VAE batches 1, 4, 8, 16 | [Open](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/vae/index.html) | [Frames](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/vae/stack.png) | [Details](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/vae/details.png) |
+| Saved CUDA BF16 vs MLX, product | [Open](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product-cuda/index.html) | [Frames](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product-cuda/stack.png) | [Details](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/product-cuda/details.png) |
+| Saved CUDA BF16 vs MLX, portrait | [Open](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/portrait-cuda/index.html) | [Frames](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/portrait-cuda/stack.png) | [Details](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/portrait-cuda/details.png) |
+| Saved CUDA BF16 vs MLX, native 4K | [Open](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/native-4k-cuda/index.html) | [Frames](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/native-4k-cuda/stack.png) | [Details](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/native-4k-cuda/details.png) |
+
+[The editing demonstration](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx-examples/blob/v0.4.0/comparisons/edit-example/before-after.png) places the input
+reference beside the native MLX emerald-glass edit. It is a functional example,
+not a pixel-similarity comparison.
+
+The CUDA comparison uses the original saved RTX 5090 BF16 run with upstream
+`quality=lossless`. Its hardware and decoder quality setting differ from the
+MLX native tile recipe. It provides visual context; it does not isolate port
+error or establish a same-hardware speedup.
+
+The default MLX BF16 output is the reference for the quantization/tuning
+comparisons. Q8, Q4, fused kernels and fewer steps change its pixels. Read the
+[experiment report](../reports/RESULTS.md) before selecting a profile.
+
+Full-resolution Mac outputs and trace tensors are retained locally under
+`outputs/suite/` (ignored by Git). Source hashes, configuration, memory and
+timing records are exported under `reports/inference/` and each gallery's
+`metrics.json`. Original model weights are not included.

comparisons/cuda-reference/native-4k.json

@@ -0,0 +1,63 @@
+{
+  "prompt": "An overhead editorial photograph of an oceanographer's desk: a coiled orange rope, silver calipers, a pale-blue sea chart with fine contour lines, a black-and-white photograph of a lighthouse, a few tiny shells and a weathered brass compass. On a pale notecard write 'NORTH STAR' in neat bold navy capitals. One shaft of late afternoon sunlight, precise paper fibers and metal scratches, realistic soft shadows, a carefully balanced square composition.",
+  "seed": 802,
+  "size": [
+    4096,
+    4096
+  ],
+  "canvas": [
+    4096,
+    4096
+  ],
+  "rng": "torch",
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "output": "comparisons/cuda-reference/native-4k.png",
+  "timings": {
+    "total_s": 32.5837
+  },
+  "environment": {
+    "device": "RTX 5090",
+    "backend": "SGLang CUDA",
+    "quality": "lossless"
+  },
+  "source_record": {
+    "label": "single-bf16-stream",
+    "case": "native-4k",
+    "trial": 1,
+    "wall_seconds": 32.5837,
+    "image_bytes": 50339652,
+    "sha256": "7fd381c76d07a3f5a5e3f1982d454d31c56101f9af22c70900aab983e8465bee",
+    "size": "4096x4096",
+    "seed": 802,
+    "task": "text-to-image",
+    "quality": "lossless",
+    "output_compression": 1,
+    "attention_override": null,
+    "h3_opt": null,
+    "prompt": "An overhead editorial photograph of an oceanographer's desk: a coiled orange rope, silver calipers, a pale-blue sea chart with fine contour lines, a black-and-white photograph of a lighthouse, a few tiny shells and a weathered brass compass. On a pale notecard write 'NORTH STAR' in neat bold navy capitals. One shaft of late afternoon sunlight, precise paper fibers and metal scratches, realistic soft shadows, a carefully balanced square composition."
+  },
+  "reference_images": [],
+  "reference_sha256": [],
+  "dit": {
+    "precision": "BF16"
+  },
+  "vae": {
+    "quality": "lossless"
+  }
+}

comparisons/cuda-reference/portrait.json

@@ -0,0 +1,63 @@
+{
+  "prompt": "An intimate natural-light portrait of an elderly woman in a botanical conservatory, reading a small red clothbound book. Warm brown skin with visible freckles and fine wrinkles, silver curls lit from behind, intricate indigo knit cardigan. Soft fern fronds out of focus in the foreground; detailed hands and realistic skin texture. A candid 85mm color photograph with gentle shadows and no lettering.",
+  "seed": 1234,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "output": "comparisons/cuda-reference/portrait.png",
+  "timings": {
+    "total_s": 6.7668
+  },
+  "environment": {
+    "device": "RTX 5090",
+    "backend": "SGLang CUDA",
+    "quality": "lossless"
+  },
+  "source_record": {
+    "label": "single-bf16-stream",
+    "case": "portrait",
+    "trial": 1,
+    "wall_seconds": 6.7668,
+    "image_bytes": 12585988,
+    "sha256": "a8e360798a511a2b74f7ee8679699d253282afcf01423f6496f504a2f11c7aad",
+    "size": "2048x2048",
+    "seed": 1234,
+    "task": "text-to-image",
+    "quality": "lossless",
+    "output_compression": 1,
+    "attention_override": null,
+    "h3_opt": null,
+    "prompt": "An intimate natural-light portrait of an elderly woman in a botanical conservatory, reading a small red clothbound book. Warm brown skin with visible freckles and fine wrinkles, silver curls lit from behind, intricate indigo knit cardigan. Soft fern fronds out of focus in the foreground; detailed hands and realistic skin texture. A candid 85mm color photograph with gentle shadows and no lettering."
+  },
+  "reference_images": [],
+  "reference_sha256": [],
+  "dit": {
+    "precision": "BF16"
+  },
+  "vae": {
+    "quality": "lossless"
+  }
+}

comparisons/cuda-reference/product.json

@@ -0,0 +1,63 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "output": "comparisons/cuda-reference/product.png",
+  "timings": {
+    "total_s": 6.7003
+  },
+  "environment": {
+    "device": "RTX 5090",
+    "backend": "SGLang CUDA",
+    "quality": "lossless"
+  },
+  "source_record": {
+    "label": "single-bf16-stream",
+    "case": "product",
+    "trial": 1,
+    "wall_seconds": 6.7003,
+    "image_bytes": 12585988,
+    "sha256": "66a49c7b9d281bf7a4b22356b625bdbee8e92e02b8d8d2031cc24f73601ad531",
+    "size": "2048x2048",
+    "seed": 731,
+    "task": "text-to-image",
+    "quality": "lossless",
+    "output_compression": 1,
+    "attention_override": null,
+    "h3_opt": null,
+    "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text."
+  },
+  "reference_images": [],
+  "reference_sha256": [],
+  "dit": {
+    "precision": "BF16"
+  },
+  "vae": {
+    "quality": "lossless"
+  }
+}

comparisons/edit-example/record.json

@@ -0,0 +1,120 @@
+{
+  "prompt": "Change the cobalt blue glass perfume bottle in <Picture 1> to deep emerald green glass. Preserve the pale engraved NIGHT TIDE label, exact lettering, bottle shape, cap, stone backdrop, composition, lighting and shadows. The glass should be visibly green with realistic emerald highlights and reflections.",
+  "seed": 42,
+  "size": [
+    1024,
+    1024
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "dit": {
+    "cache_dir": "cache",
+    "cache_gb": 38,
+    "bits": null,
+    "group_size": 64,
+    "mlp_chunk": 0,
+    "query_chunk": 0,
+    "kernel": "native",
+    "threads": 256,
+    "quantized_path": null
+  },
+  "encoder": {
+    "cache_dir": "cache",
+    "bits": null,
+    "group_size": 64,
+    "query_chunk": 0
+  },
+  "vae": {
+    "tile_batch": 1,
+    "dtype": "bfloat16"
+  },
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "timings": {
+    "encode_s": 28.711510707857087,
+    "dit_setup_s": 0.3510471251793206,
+    "step_0_s": 32.27381366607733,
+    "step_1_s": 18.178750790888444,
+    "step_2_s": 17.952110541053116,
+    "step_3_s": 17.822316124802455,
+    "step_4_s": 17.744772125035524,
+    "step_5_s": 17.770629958016798,
+    "decode_s": 4.267031416995451,
+    "total_s": 157.7393269999884
+  },
+  "reference_images": [
+    "experiments/reference-bottle.png"
+  ],
+  "reference_sha256": [
+    "96d23a5fb97d8dbff46990ec6c13a8caf8573f2b4d41820c9cae0efc3d0b872c"
+  ],
+  "conditioning_cache_hit": false,
+  "dit_effective": {
+    "bits": null,
+    "group_size": 64,
+    "cache_limit_gb": 38.0,
+    "checkpoint_fingerprint": "d92ff1655d366a65a0964dc770fb50a3db623de2f490371e82776a10e2d5d900"
+  },
+  "dit_was_resident": false,
+  "dit_metrics": {
+    "block_load_s": 16.658172828843817,
+    "block_compute_s": 105.10201758518815,
+    "block_loads": 52
+  },
+  "memory_before_decode": {
+    "active_gb": 36.05878337472677,
+    "peak_gb": 37.71541484631598,
+    "cache_gb": 0.9982056273147464
+  },
+  "memory": {
+    "active_gb": 36.81037116795778,
+    "peak_gb": 37.71541484631598,
+    "cache_gb": 0.31941457837820053
+  },
+  "output": "outputs/suite/edit/native-0.png",
+  "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304"
+}

comparisons/native-4k-cuda/metrics.json

@@ -0,0 +1,75 @@
+{
+  "validation_scope": "Cross-backend comparison: hardware and VAE quality settings differ. Timings do not isolate a port speedup.",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/cuda-reference/native-4k.png",
+  "native_size": [
+    4096,
+    4096
+  ],
+  "crop_xyxy": [
+    1792,
+    1792,
+    2304,
+    2304
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "CUDA BF16 / upstream lossless quality",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/cuda-reference/native-4k.png",
+      "png_sha256": "7fd381c76d07a3f5a5e3f1982d454d31c56101f9af22c70900aab983e8465bee",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "total_s": 32.5837
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "MLX BF16 / native tile recipe",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/suite/native-4k/native-0.png",
+      "png_sha256": "9f5b1f2a4d1ef45900e8afd7bf132e43f437c0ded73a79aa6992fe0a968de3c6",
+      "pixel_identical": false,
+      "mae_8bit": 10.43891042470932,
+      "max_error_8bit": 255,
+      "psnr_db": 21.472787391510856,
+      "ssim_rgb": 0.8437432938484267,
+      "timings": {
+        "encode_s": 39.3051441248972,
+        "dit_setup_s": 1.2301222910173237,
+        "step_0_s": 71.125005583046,
+        "step_1_s": 65.16590758296661,
+        "step_2_s": 65.27136183297262,
+        "step_3_s": 65.02919550007209,
+        "step_4_s": 65.43438254203647,
+        "step_5_s": 65.73626679205336,
+        "decode_s": 12.110308207804337
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Saved DiT stages plus separately timed corrected decoder; no fresh end-to-end total"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-compact/edit/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/edit/control-validation-0.png",
+  "native_size": [
+    1024,
+    1024
+  ],
+  "crop_xyxy": [
+    256,
+    256,
+    768,
+    768
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/edit/control-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.0944433338008821,
+        "dit_setup_s": 0.018301625037565827,
+        "step_0_s": 16.044049208052456,
+        "step_1_s": 16.64705704106018,
+        "step_2_s": 16.798973750090227,
+        "step_3_s": 16.80766825005412,
+        "step_4_s": 16.82632016693242,
+        "step_5_s": 16.788526582997292,
+        "decode_s": 1.7753529578913003,
+        "total_s": 104.33122787508182
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/edit/qk-fc2-native-norm-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09382429183460772,
+        "dit_setup_s": 0.005678124958649278,
+        "step_0_s": 15.517480874899775,
+        "step_1_s": 15.885630707954988,
+        "step_2_s": 16.043985707918182,
+        "step_3_s": 16.065357791027054,
+        "step_4_s": 16.00308766681701,
+        "step_5_s": 16.0314345411025,
+        "decode_s": 1.806969250086695,
+        "total_s": 99.78968337504193
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-compact/holdout-detail/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/holdout-detail/control-validation-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/holdout-detail/control-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08503512479364872,
+        "dit_setup_s": 0.0054474580101668835,
+        "step_0_s": 10.586685917107388,
+        "step_1_s": 10.475943374913186,
+        "step_2_s": 10.536071791080758,
+        "step_3_s": 10.609299124917015,
+        "step_4_s": 10.648755833040923,
+        "step_5_s": 10.659710499923676,
+        "decode_s": 1.892699166899547,
+        "total_s": 65.62054104101844
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/holdout-detail/qk-fc2-native-norm-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08309245808050036,
+        "dit_setup_s": 0.0016110001597553492,
+        "step_0_s": 10.02036679093726,
+        "step_1_s": 10.222182292025536,
+        "step_2_s": 10.317761083133519,
+        "step_3_s": 10.258633374935016,
+        "step_4_s": 10.214116165880114,
+        "step_5_s": 10.211255375063047,
+        "decode_s": 1.9069041248876601,
+        "total_s": 63.36157112498768
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-compact/portrait/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/portrait/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/portrait/control-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08196645905263722,
+        "dit_setup_s": 0.0020813329610973597,
+        "step_0_s": 10.599762792000547,
+        "step_1_s": 10.859696834115312,
+        "step_2_s": 10.841980583034456,
+        "step_3_s": 10.818649291992188,
+        "step_4_s": 10.812689499929547,
+        "step_5_s": 10.815967541886494,
+        "decode_s": 1.8206247920170426,
+        "total_s": 66.77446975000203
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/portrait/qk-fc2-native-norm-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08218058408237994,
+        "dit_setup_s": 0.0021450419444590807,
+        "step_0_s": 10.038613541051745,
+        "step_1_s": 10.278275415999815,
+        "step_2_s": 10.234170750016347,
+        "step_3_s": 10.295444874791428,
+        "step_4_s": 10.20847308402881,
+        "step_5_s": 10.264521708944812,
+        "decode_s": 1.9153460001107305,
+        "total_s": 63.443048041081056
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-compact/product/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/product/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/product/control-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08302924991585314,
+        "dit_setup_s": 0.0021304169204086065,
+        "step_0_s": 10.524454500060529,
+        "step_1_s": 10.518413708079606,
+        "step_2_s": 10.792438166914508,
+        "step_3_s": 10.938075749902055,
+        "step_4_s": 10.803379165939987,
+        "step_5_s": 10.852768250042573,
+        "decode_s": 1.939876874908805,
+        "total_s": 66.73659237497486
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-compact/product/qk-fc2-native-norm-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08724224986508489,
+        "dit_setup_s": 0.0015401248820126057,
+        "step_0_s": 10.171907834010199,
+        "step_1_s": 10.420595958130434,
+        "step_2_s": 10.435337207978591,
+        "step_3_s": 10.569814499933273,
+        "step_4_s": 10.503622999880463,
+        "step_5_s": 10.588133125100285,
+        "decode_s": 1.9536084169521928,
+        "total_s": 64.8621540828608
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-deployment/edit/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/edit/control-validation-0.png",
+  "native_size": [
+    1024,
+    1024
+  ],
+  "crop_xyxy": [
+    256,
+    256,
+    768,
+    768
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/edit/control-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09496295801363885,
+        "dit_setup_s": 0.018790250178426504,
+        "step_0_s": 16.496046874905005,
+        "step_1_s": 17.588394791819155,
+        "step_2_s": 17.459331332938746,
+        "step_3_s": 17.59560624998994,
+        "step_4_s": 17.775859917048365,
+        "step_5_s": 17.98469966603443,
+        "decode_s": 1.7778672080021352,
+        "total_s": 109.37410999997519
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/edit/qk-fc2-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.0946252909488976,
+        "dit_setup_s": 0.005771707976236939,
+        "step_0_s": 15.780252208001912,
+        "step_1_s": 16.24150708410889,
+        "step_2_s": 16.135149333858863,
+        "step_3_s": 16.180468250066042,
+        "step_4_s": 16.37875320808962,
+        "step_5_s": 16.147045334102586,
+        "decode_s": 1.7784138328861445,
+        "total_s": 100.89215162489563
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-deployment/holdout-detail/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/holdout-detail/control-validation-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/holdout-detail/control-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08760958397760987,
+        "dit_setup_s": 0.005459541920572519,
+        "step_0_s": 10.42564162495546,
+        "step_1_s": 10.77243841602467,
+        "step_2_s": 10.619838000042364,
+        "step_3_s": 10.630091832950711,
+        "step_4_s": 10.930967458989471,
+        "step_5_s": 10.638426082907245,
+        "decode_s": 1.9144813329912722,
+        "total_s": 66.1562814170029
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/holdout-detail/qk-fc2-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08267062506638467,
+        "dit_setup_s": 0.002635624958202243,
+        "step_0_s": 9.876321790972725,
+        "step_1_s": 9.873472125036642,
+        "step_2_s": 9.758229917148128,
+        "step_3_s": 9.659938625060022,
+        "step_4_s": 9.70524508296512,
+        "step_5_s": 9.690499417018145,
+        "decode_s": 1.8380374158732593,
+        "total_s": 60.60736404103227
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-deployment/portrait/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/portrait/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/portrait/control-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08375041605904698,
+        "dit_setup_s": 0.0014606250915676355,
+        "step_0_s": 10.343989124987274,
+        "step_1_s": 10.484140957938507,
+        "step_2_s": 10.492746208095923,
+        "step_3_s": 10.494633583119139,
+        "step_4_s": 10.36117170797661,
+        "step_5_s": 10.398765416117385,
+        "decode_s": 1.8557565829250962,
+        "total_s": 64.64417616720311
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/portrait/qk-fc2-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08595199999399483,
+        "dit_setup_s": 0.0023597090039402246,
+        "step_0_s": 9.701315457932651,
+        "step_1_s": 9.964592250064015,
+        "step_2_s": 9.679471249924973,
+        "step_3_s": 9.77542870794423,
+        "step_4_s": 9.722767374943942,
+        "step_5_s": 9.726279291789979,
+        "decode_s": 1.84116454096511,
+        "total_s": 60.62431841692887
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-deployment/product/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/product/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/product/control-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08194691711105406,
+        "dit_setup_s": 0.001686332980170846,
+        "step_0_s": 10.51596958306618,
+        "step_1_s": 11.313274249900132,
+        "step_2_s": 11.170203125104308,
+        "step_3_s": 11.17257241695188,
+        "step_4_s": 11.15542795881629,
+        "step_5_s": 11.049065208993852,
+        "decode_s": 1.9435918340459466,
+        "total_s": 68.77809108304791
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-deployment/product/qk-fc2-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09126312495209277,
+        "dit_setup_s": 0.0016431249678134918,
+        "step_0_s": 10.12600183300674,
+        "step_1_s": 10.25785204092972,
+        "step_2_s": 10.31819008407183,
+        "step_3_s": 10.244670124957338,
+        "step_4_s": 10.107232958078384,
+        "step_5_s": 10.029554083012044,
+        "decode_s": 1.9170843749307096,
+        "total_s": 63.23245245893486
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-qk/edit/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/edit/control-validation-0.png",
+  "native_size": [
+    1024,
+    1024
+  ],
+  "crop_xyxy": [
+    256,
+    256,
+    768,
+    768
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/edit/control-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09503345820121467,
+        "dit_setup_s": 0.018574999878183007,
+        "step_0_s": 16.138278875034302,
+        "step_1_s": 17.324966541025788,
+        "step_2_s": 17.10170820890926,
+        "step_3_s": 17.527415458112955,
+        "step_4_s": 17.178513792110607,
+        "step_5_s": 17.10299470787868,
+        "decode_s": 1.7370757500175387,
+        "total_s": 107.01361245894805
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/edit/qk-fc2-native-norm-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09180762502364814,
+        "dit_setup_s": 0.00593545800074935,
+        "step_0_s": 15.591749583836645,
+        "step_1_s": 16.14866058388725,
+        "step_2_s": 16.148559999885038,
+        "step_3_s": 16.13089166698046,
+        "step_4_s": 16.0815456667915,
+        "step_5_s": 16.000552749959752,
+        "decode_s": 1.7590807920787483,
+        "total_s": 100.12193545908667
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-qk/holdout-detail/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/holdout-detail/control-validation-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/holdout-detail/control-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08907995908521116,
+        "dit_setup_s": 0.005445417016744614,
+        "step_0_s": 10.186366624897346,
+        "step_1_s": 10.398944000015035,
+        "step_2_s": 10.388187959091738,
+        "step_3_s": 10.393390582874417,
+        "step_4_s": 10.412437124876305,
+        "step_5_s": 10.425708208000287,
+        "decode_s": 1.8648124169558287,
+        "total_s": 64.29311916604638
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/holdout-detail/qk-fc2-native-norm-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08324970793910325,
+        "dit_setup_s": 0.002322999993339181,
+        "step_0_s": 9.82555766706355,
+        "step_1_s": 10.011389791965485,
+        "step_2_s": 10.023319042054936,
+        "step_3_s": 9.948340374976397,
+        "step_4_s": 9.975905125029385,
+        "step_5_s": 10.093045125016943,
+        "decode_s": 1.8749908339232206,
+        "total_s": 61.96455545909703
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-qk/portrait/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/portrait/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/portrait/control-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08343583298847079,
+        "dit_setup_s": 0.001739458180963993,
+        "step_0_s": 10.410045666852966,
+        "step_1_s": 10.420791167067364,
+        "step_2_s": 10.387041166890413,
+        "step_3_s": 10.363457958912477,
+        "step_4_s": 10.30392266716808,
+        "step_5_s": 10.31452420912683,
+        "decode_s": 1.8196195410564542,
+        "total_s": 64.2339057920035
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/portrait/qk-fc2-native-norm-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08363316603936255,
+        "dit_setup_s": 0.0014190839137881994,
+        "step_0_s": 9.715915624983609,
+        "step_1_s": 9.817784250015393,
+        "step_2_s": 9.768883208977059,
+        "step_3_s": 9.779015209060162,
+        "step_4_s": 9.768648916855454,
+        "step_5_s": 9.780800291104242,
+        "decode_s": 1.8109615000430495,
+        "total_s": 60.65490966709331
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3-qk/product/qk-fc2-native-norm/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/product/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/product/control-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08855687500908971,
+        "dit_setup_s": 0.0017782910726964474,
+        "step_0_s": 9.8694685830269,
+        "step_1_s": 11.024087708909065,
+        "step_2_s": 10.974625166971236,
+        "step_3_s": 10.970295834122226,
+        "step_4_s": 10.889125291956589,
+        "step_5_s": 10.934292541118339,
+        "decode_s": 1.9161692501511425,
+        "total_s": 67.02427170914598
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2-native-norm",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3-qk/product/qk-fc2-native-norm-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08656845916993916,
+        "dit_setup_s": 0.0020523329731076956,
+        "step_0_s": 10.22877712501213,
+        "step_1_s": 10.409983040997759,
+        "step_2_s": 10.289188583847135,
+        "step_3_s": 10.299693416105583,
+        "step_4_s": 10.278323167003691,
+        "step_5_s": 10.27706433297135,
+        "decode_s": 1.8995202500373125,
+        "total_s": 63.90098704188131
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3/edit/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/edit/control-validation-0.png",
+  "native_size": [
+    1024,
+    1024
+  ],
+  "crop_xyxy": [
+    256,
+    256,
+    768,
+    768
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/edit/control-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09193570795468986,
+        "dit_setup_s": 0.00586116686463356,
+        "step_0_s": 17.43612916697748,
+        "step_1_s": 17.915810333099216,
+        "step_2_s": 17.71518375002779,
+        "step_3_s": 17.54526187502779,
+        "step_4_s": 17.438321667024866,
+        "step_5_s": 17.364450709195808,
+        "decode_s": 1.7734632920473814,
+        "total_s": 109.67779112490825
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/edit/qk-fc2-validation-0.png",
+      "png_sha256": "9df3f80efa5ef9f078c9acda81febdbc2d5d706f3c85c574fdfd9fd274b71304",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09640745911747217,
+        "dit_setup_s": 0.006049292162060738,
+        "step_0_s": 15.941608458058909,
+        "step_1_s": 16.155159290879965,
+        "step_2_s": 16.165109500056133,
+        "step_3_s": 16.26405395916663,
+        "step_4_s": 16.198108582990244,
+        "step_5_s": 16.064961167052388,
+        "decode_s": 1.7583504170179367,
+        "total_s": 100.86470816703513
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3/gallery.json

@@ -0,0 +1,98 @@
+[
+  {
+    "group": "Exact Q/K fusion + FC2 tuning",
+    "case": "product",
+    "gallery": "comparisons/optimization-r3-qk/product/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "49cb9beabd26f0fd062720ff5778e706fe60e06d31cfb88e3d2ece05c502f893",
+    "grid_sha256": "be898f85d2c0bcd0a90d9a4800cf80e7d3beae1c3df656280fb28b92cb015ac7",
+    "pixel_identical": true
+  },
+  {
+    "group": "Exact Q/K fusion + FC2 tuning",
+    "case": "portrait",
+    "gallery": "comparisons/optimization-r3-qk/portrait/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "9ea037662ba4f0e1edf08d83c6fab2e9929626831cc32a4a61ed540e531e8807",
+    "grid_sha256": "700c4593945ef70374cf8ca8d78e516d2acc04b122906538b2976b0d659a59de",
+    "pixel_identical": true
+  },
+  {
+    "group": "Exact Q/K fusion + FC2 tuning",
+    "case": "holdout-detail",
+    "gallery": "comparisons/optimization-r3-qk/holdout-detail/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "4775d06f38348f216efb8b5ba42ada72077ef087d65b83f8e3accdfa1af87df9",
+    "grid_sha256": "31f84926000a62f32f753bd338c9b36f17188cd35acd1a63cf3d70eaaf33f73d",
+    "pixel_identical": true
+  },
+  {
+    "group": "Exact Q/K fusion + FC2 tuning",
+    "case": "edit",
+    "gallery": "comparisons/optimization-r3-qk/edit/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "d1969a84e778912065751bba2037db6c13a74aa32c0f442ecc61c5b82eee8da9",
+    "grid_sha256": "5da61cb450c4b90fad6f42178b6a22367db5a54c02aaf7b47b215a8bd196047c",
+    "pixel_identical": true
+  },
+  {
+    "group": "Lossless packed weights + exact tuning",
+    "case": "product",
+    "gallery": "comparisons/optimization-r3-compact/product/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "b463bc389757d18fb52f502a1e6f3a564c975f6beb13ca2321c39a57cf86e1b7",
+    "grid_sha256": "be898f85d2c0bcd0a90d9a4800cf80e7d3beae1c3df656280fb28b92cb015ac7",
+    "pixel_identical": true
+  },
+  {
+    "group": "Lossless packed weights + exact tuning",
+    "case": "portrait",
+    "gallery": "comparisons/optimization-r3-compact/portrait/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "45f490f5a6ec12f32db054f4aedee0b7dbe302592018b24116be3e06702cadb4",
+    "grid_sha256": "700c4593945ef70374cf8ca8d78e516d2acc04b122906538b2976b0d659a59de",
+    "pixel_identical": true
+  },
+  {
+    "group": "Lossless packed weights + exact tuning",
+    "case": "holdout-detail",
+    "gallery": "comparisons/optimization-r3-compact/holdout-detail/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "575108c69e22d78093498f7db49bfd8cd96ef4886c1c0049852746c5de874d56",
+    "grid_sha256": "31f84926000a62f32f753bd338c9b36f17188cd35acd1a63cf3d70eaaf33f73d",
+    "pixel_identical": true
+  },
+  {
+    "group": "Lossless packed weights + exact tuning",
+    "case": "edit",
+    "gallery": "comparisons/optimization-r3-compact/edit/qk-fc2-native-norm/index.html",
+    "metrics_sha256": "1b521c42efdca3075605036fc51bc86e27c3cd9fb8c3aded100085a30422c427",
+    "grid_sha256": "5da61cb450c4b90fad6f42178b6a22367db5a54c02aaf7b47b215a8bd196047c",
+    "pixel_identical": true
+  },
+  {
+    "group": "Full-width fusion: exact pixels, memory tradeoff",
+    "case": "product",
+    "gallery": "comparisons/optimization-r3-deployment/product/qk-fc2/index.html",
+    "metrics_sha256": "5a3bc54f6b0916d83a1bf70d7af55989a234011fdcd2409fc74955a289783b03",
+    "grid_sha256": "b7d9451370370d8428aad4847d86ac3982ceec1c5b4af0b90c5bb43d77e9a21f",
+    "pixel_identical": true
+  },
+  {
+    "group": "Full-width fusion: exact pixels, memory tradeoff",
+    "case": "portrait",
+    "gallery": "comparisons/optimization-r3-deployment/portrait/qk-fc2/index.html",
+    "metrics_sha256": "859bd41ce5bd6c6611dfc3716cfdb4e698869477856c8c55e0cccc5314c8b4cd",
+    "grid_sha256": "517416f9020f0be9692914e18ba0bd8c5e11df84bc4bf1e1afc732f06b2606a2",
+    "pixel_identical": true
+  },
+  {
+    "group": "Full-width fusion: exact pixels, memory tradeoff",
+    "case": "holdout-detail",
+    "gallery": "comparisons/optimization-r3-deployment/holdout-detail/qk-fc2/index.html",
+    "metrics_sha256": "7ff107dd7a594c524c3096601ce938c2485b97d2dce22a6250506d37ac86ea52",
+    "grid_sha256": "47bac50ff41f08d8ae4e45fd7e269340aadca8e7fdec4fb0c889ab6bd8db1e88",
+    "pixel_identical": true
+  },
+  {
+    "group": "Full-width fusion: exact pixels, memory tradeoff",
+    "case": "edit",
+    "gallery": "comparisons/optimization-r3-deployment/edit/qk-fc2/index.html",
+    "metrics_sha256": "a9881cfa4f375b17fc9872cdd162bf864313b8c7b17bf5797a619f998f063f92",
+    "grid_sha256": "52d3a40d35505c1c893c2e1917d7367b9aa3faf815b341f6740b5eccbea3280b",
+    "pixel_identical": true
+  }
+]

comparisons/optimization-r3/holdout-detail/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/holdout-detail/control-validation-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/holdout-detail/control-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08546350011602044,
+        "dit_setup_s": 0.0028562501538544893,
+        "step_0_s": 10.619318875018507,
+        "step_1_s": 10.635955666890368,
+        "step_2_s": 10.632296457886696,
+        "step_3_s": 10.644406750099733,
+        "step_4_s": 10.566011917078868,
+        "step_5_s": 10.629142459016293,
+        "decode_s": 1.9020051669795066,
+        "total_s": 65.84704962512478
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/holdout-detail/qk-fc2-validation-0.png",
+      "png_sha256": "ddbfc06c4556c08669d35a4618d380a99998e39a0226e7688d149993ab183038",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08358391700312495,
+        "dit_setup_s": 0.0018770832102745771,
+        "step_0_s": 9.848138374974951,
+        "step_1_s": 9.98282212507911,
+        "step_2_s": 10.09999533300288,
+        "step_3_s": 10.163251249818131,
+        "step_4_s": 10.270917958114296,
+        "step_5_s": 10.198511166963726,
+        "decode_s": 1.904920166125521,
+        "total_s": 62.68734062509611
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3/portrait/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/portrait/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/portrait/control-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08550125011242926,
+        "dit_setup_s": 0.0015632910653948784,
+        "step_0_s": 10.885879541980103,
+        "step_1_s": 11.088049875106663,
+        "step_2_s": 11.107039166148752,
+        "step_3_s": 11.065090750111267,
+        "step_4_s": 10.819651541067287,
+        "step_5_s": 10.922892624977976,
+        "decode_s": 1.9121064159553498,
+        "total_s": 68.0219049169682
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/portrait/qk-fc2-timed-0.png",
+      "png_sha256": "32af5e3b95919e79e0019058ec396824c5861f9a43a4fa50c7b20348e8d81933",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.08716454193927348,
+        "dit_setup_s": 0.0025339999701827765,
+        "step_0_s": 10.343852832913399,
+        "step_1_s": 10.311937124934047,
+        "step_2_s": 10.07040312513709,
+        "step_3_s": 10.080784375080839,
+        "step_4_s": 10.095044541871175,
+        "step_5_s": 10.125651291804388,
+        "decode_s": 1.8876813750248402,
+        "total_s": 63.14736045780592
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-r3/product/qk-fc2/metrics.json

@@ -0,0 +1,85 @@
+{
+  "validation_scope": "Complete image inference",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/product/control-timed-0.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Current BF16 control",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/product/control-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.0853560408577323,
+        "dit_setup_s": 0.0015609171241521835,
+        "step_0_s": 10.232307167025283,
+        "step_1_s": 11.155369125073776,
+        "step_2_s": 11.181794625008479,
+        "step_3_s": 11.19105491694063,
+        "step_4_s": 11.266168375033885,
+        "step_5_s": 11.14753987500444,
+        "decode_s": 1.9626916251145303,
+        "total_s": 68.59933650004677
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "qk-fc2",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/optimization-r3/product/qk-fc2-timed-0.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.0866880000103265,
+        "dit_setup_s": 0.0022984161041677,
+        "step_0_s": 10.573326792102307,
+        "step_1_s": 10.764806583058089,
+        "step_2_s": 10.743913582991809,
+        "step_3_s": 10.55372745799832,
+        "step_4_s": 10.52767491596751,
+        "step_5_s": 10.614938125014305,
+        "decode_s": 1.9278774580452591,
+        "total_s": 65.93319679214619
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-v2/contiguous-b1-CPU_AND_NE/comparison/metrics.json

@@ -0,0 +1,76 @@
+{
+  "validation_scope": "Same final latent; decoder-only comparison. Source-generation and decoder-only timings have different scopes.",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/suite/product/native-3.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Native BF16 decoder",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/suite/product/native-3.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09756437502801418,
+        "dit_setup_s": 1.1571008330211043,
+        "step_0_s": 10.822453290922567,
+        "step_1_s": 11.303021250059828,
+        "step_2_s": 11.45283200009726,
+        "step_3_s": 11.480994417099282,
+        "step_4_s": 11.41636574990116,
+        "step_5_s": 11.394194666063413,
+        "decode_s": 3.528030874906108,
+        "total_s": 72.77735170791857
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "Core ML CPU_AND_NE, batch 1, contiguous bridge",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/contiguous-b1-CPU_AND_NE/image.png",
+      "png_sha256": "a72edf0d9bd4148b6c1d22821102bd096229911889e1d5d95350bddc545a34ac",
+      "pixel_identical": false,
+      "mae_8bit": 1.1787954171498616,
+      "max_error_8bit": 43,
+      "psnr_db": 42.42709412463761,
+      "ssim_rgb": 0.9889744364650547,
+      "timings": {
+        "decode_s": 30.625669125001878
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "One complete decoder pass; model loading excluded"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-v2/contiguous-b1-CPU_AND_NE/image.json

@@ -0,0 +1,68 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "One complete decoder pass; model loading excluded",
+  "timings": {
+    "decode_s": 30.625669125001878
+  },
+  "load_s": 47.709695749916136,
+  "vae_backend": "coreml",
+  "vae": {
+    "batch": 1,
+    "compute_units": "CPU_AND_NE"
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/contiguous-b1-CPU_AND_NE/image.png",
+  "png_sha256": "a72edf0d9bd4148b6c1d22821102bd096229911889e1d5d95350bddc545a34ac",
+  "numpy_bridge": {
+    "output_shape": [
+      1,
+      3,
+      256,
+      256
+    ],
+    "output_strides": [
+      786432,
+      262144,
+      1024,
+      4
+    ],
+    "output_c_contiguous": true,
+    "original_mlx_numpy_import_exact": true
+  },
+  "pixel_identical": false,
+  "mae_8bit": 1.1787954171498616,
+  "max_error_8bit": 43,
+  "psnr_db": 42.42709412463761,
+  "ssim_rgb": 0.9889744364650547
+}

comparisons/optimization-v2/contiguous-b8-CPU_AND_GPU/comparison/metrics.json

@@ -0,0 +1,76 @@
+{
+  "validation_scope": "Same final latent; decoder-only comparison. Source-generation and decoder-only timings have different scopes.",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/suite/product/native-3.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "Native BF16 decoder",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/outputs/suite/product/native-3.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "encode_s": 0.09756437502801418,
+        "dit_setup_s": 1.1571008330211043,
+        "step_0_s": 10.822453290922567,
+        "step_1_s": 11.303021250059828,
+        "step_2_s": 11.45283200009726,
+        "step_3_s": 11.480994417099282,
+        "step_4_s": 11.41636574990116,
+        "step_5_s": 11.394194666063413,
+        "decode_s": 3.528030874906108,
+        "total_s": 72.77735170791857
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Fresh end-to-end request"
+    },
+    {
+      "label": "Core ML CPU_AND_GPU, batch 8, contiguous bridge",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/contiguous-b8-CPU_AND_GPU/image.png",
+      "png_sha256": "36a7cdad88b12839d1e4cd30384ee60fafffaac52d2ba05e3be409a33a40a50a",
+      "pixel_identical": false,
+      "mae_8bit": 0.2054581642150879,
+      "max_error_8bit": 7,
+      "psnr_db": 54.674052201530415,
+      "ssim_rgb": 0.9983190643001968,
+      "timings": {
+        "decode_s": 1.8162069998215884
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "One complete decoder pass; model loading excluded"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-v2/contiguous-b8-CPU_AND_GPU/image.json

@@ -0,0 +1,68 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "One complete decoder pass; model loading excluded",
+  "timings": {
+    "decode_s": 1.8162069998215884
+  },
+  "load_s": 10.882885874947533,
+  "vae_backend": "coreml",
+  "vae": {
+    "batch": 8,
+    "compute_units": "CPU_AND_GPU"
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/contiguous-b8-CPU_AND_GPU/image.png",
+  "png_sha256": "36a7cdad88b12839d1e4cd30384ee60fafffaac52d2ba05e3be409a33a40a50a",
+  "numpy_bridge": {
+    "output_shape": [
+      8,
+      3,
+      256,
+      256
+    ],
+    "output_strides": [
+      786432,
+      262144,
+      1024,
+      4
+    ],
+    "output_c_contiguous": true,
+    "original_mlx_numpy_import_exact": true
+  },
+  "pixel_identical": false,
+  "mae_8bit": 0.2054581642150879,
+  "max_error_8bit": 7,
+  "psnr_db": 54.674052201530415,
+  "ssim_rgb": 0.9983190643001968
+}

comparisons/optimization-v2/decoder-all-product/comparison/metrics.json

@@ -0,0 +1,221 @@
+{
+  "validation_scope": "Same final latent; decoder only",
+  "reference": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/native-b1.png",
+  "native_size": [
+    2048,
+    2048
+  ],
+  "crop_xyxy": [
+    768,
+    768,
+    1280,
+    1280
+  ],
+  "heatmap_gain": 8,
+  "metric_definition": {
+    "psnr": "Full-resolution 8-bit RGB MSE, data range 255; null means infinity",
+    "ssim": "scikit-image RGB structural_similarity, channel_axis=-1, data_range=255, default 7x7 window",
+    "mae": "Full-resolution mean absolute 8-bit RGB error"
+  },
+  "rows": [
+    {
+      "label": "native-b1",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/native-b1.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "decode_s": 3.125603290973231
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "native-b4",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/native-b4.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "decode_s": 2.1325830419082195
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "compiled-b4",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/compiled-b4.png",
+      "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293",
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0,
+      "timings": {
+        "decode_s": 1.557951333001256
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "native-b8",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/native-b8.png",
+      "png_sha256": "57a85569ad45d469b191470541e8cfff8d576fed6cc6bb8bd54db16e9bd2d81f",
+      "pixel_identical": false,
+      "mae_8bit": 0.1251803239186605,
+      "max_error_8bit": 4,
+      "psnr_db": 56.9881575908215,
+      "ssim_rgb": 0.9989046120633382,
+      "timings": {
+        "decode_s": 2.0152519999537617
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "compiled-b8",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/compiled-b8.png",
+      "png_sha256": "57a85569ad45d469b191470541e8cfff8d576fed6cc6bb8bd54db16e9bd2d81f",
+      "pixel_identical": false,
+      "mae_8bit": 0.1251803239186605,
+      "max_error_8bit": 4,
+      "psnr_db": 56.9881575908215,
+      "ssim_rgb": 0.9989046120633382,
+      "timings": {
+        "decode_s": 1.530723667005077
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "coreml-CPU_ONLY",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/coreml-CPU_ONLY.png",
+      "png_sha256": "c5809bfbd3200cf980bc95960e34a52de821e9fcf529cfcddfa208c5b47dc628",
+      "pixel_identical": false,
+      "mae_8bit": 0.4373479684193929,
+      "max_error_8bit": 9,
+      "psnr_db": 50.89646445204675,
+      "ssim_rgb": 0.9957860092520554,
+      "timings": {
+        "decode_s": 11.089322166983038
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "coreml-CPU_AND_GPU",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/coreml-CPU_AND_GPU.png",
+      "png_sha256": "36a7cdad88b12839d1e4cd30384ee60fafffaac52d2ba05e3be409a33a40a50a",
+      "pixel_identical": false,
+      "mae_8bit": 0.2054581642150879,
+      "max_error_8bit": 7,
+      "psnr_db": 54.674052201530415,
+      "ssim_rgb": 0.9983190643001968,
+      "timings": {
+        "decode_s": 2.221881916979328
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "coreml-CPU_AND_NE",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/coreml-CPU_AND_NE.png",
+      "png_sha256": "20a955de357bba74e2e00fc914a12e9ebea3696326c8bd70245eff45585bd6cc",
+      "pixel_identical": false,
+      "mae_8bit": 24.426151911417644,
+      "max_error_8bit": 255,
+      "psnr_db": 14.66893789509745,
+      "ssim_rgb": 0.49229784661575254,
+      "timings": {
+        "decode_s": 7.746493499958888
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    },
+    {
+      "label": "coreml-ALL",
+      "image": "/Users/devin/Desktop/MiniMax-H3-Image-mlx/comparisons/optimization-v2/decoder-all-product/coreml-ALL.png",
+      "png_sha256": "36a7cdad88b12839d1e4cd30384ee60fafffaac52d2ba05e3be409a33a40a50a",
+      "pixel_identical": false,
+      "mae_8bit": 0.2054581642150879,
+      "max_error_8bit": 7,
+      "psnr_db": 54.674052201530415,
+      "ssim_rgb": 0.9983190643001968,
+      "timings": {
+        "decode_s": 2.028364749858156
+      },
+      "steps": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "timing_scope": "Warm decoder only; model loading excluded"
+    }
+  ],
+  "interpretation": "Pixel similarity to the same seeded trajectory, not a measure of prompt adherence or perceptual quality."
+}

comparisons/optimization-v2/decoder-all-product/compiled-b4.json

@@ -0,0 +1,72 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 4,
+    "compile_blocks": true
+  },
+  "vae_backend": "mlx",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 1.557951333001256
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/compiled-b4.png",
+  "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293"
+}

comparisons/optimization-v2/decoder-all-product/compiled-b8.json

@@ -0,0 +1,72 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 8,
+    "compile_blocks": true
+  },
+  "vae_backend": "mlx",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 1.530723667005077
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/compiled-b8.png",
+  "png_sha256": "57a85569ad45d469b191470541e8cfff8d576fed6cc6bb8bd54db16e9bd2d81f"
+}

comparisons/optimization-v2/decoder-all-product/coreml-ALL.json

@@ -0,0 +1,73 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 8,
+    "package": "cache/coreml-v2/vae-batch8.mlpackage",
+    "compute_units": "ALL"
+  },
+  "vae_backend": "coreml",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 2.028364749858156
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/coreml-ALL.png",
+  "png_sha256": "36a7cdad88b12839d1e4cd30384ee60fafffaac52d2ba05e3be409a33a40a50a"
+}

comparisons/optimization-v2/decoder-all-product/coreml-CPU_AND_GPU.json

@@ -0,0 +1,73 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 8,
+    "package": "cache/coreml-v2/vae-batch8.mlpackage",
+    "compute_units": "CPU_AND_GPU"
+  },
+  "vae_backend": "coreml",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 2.221881916979328
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/coreml-CPU_AND_GPU.png",
+  "png_sha256": "36a7cdad88b12839d1e4cd30384ee60fafffaac52d2ba05e3be409a33a40a50a"
+}

comparisons/optimization-v2/decoder-all-product/coreml-CPU_AND_NE.json

@@ -0,0 +1,73 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 8,
+    "package": "cache/coreml-v2/vae-batch8.mlpackage",
+    "compute_units": "CPU_AND_NE"
+  },
+  "vae_backend": "coreml",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 7.746493499958888
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/coreml-CPU_AND_NE.png",
+  "png_sha256": "20a955de357bba74e2e00fc914a12e9ebea3696326c8bd70245eff45585bd6cc"
+}

comparisons/optimization-v2/decoder-all-product/coreml-CPU_ONLY.json

@@ -0,0 +1,73 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 8,
+    "package": "cache/coreml-v2/vae-batch8.mlpackage",
+    "compute_units": "CPU_ONLY"
+  },
+  "vae_backend": "coreml",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 11.089322166983038
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/coreml-CPU_ONLY.png",
+  "png_sha256": "c5809bfbd3200cf980bc95960e34a52de821e9fcf529cfcddfa208c5b47dc628"
+}

comparisons/optimization-v2/decoder-all-product/native-b1.json

@@ -0,0 +1,71 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 1
+  },
+  "vae_backend": "mlx",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 3.125603290973231
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/native-b1.png",
+  "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293"
+}

comparisons/optimization-v2/decoder-all-product/native-b4.json

@@ -0,0 +1,71 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 4
+  },
+  "vae_backend": "mlx",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 2.1325830419082195
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/native-b4.png",
+  "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293"
+}

comparisons/optimization-v2/decoder-all-product/native-b8.json

@@ -0,0 +1,71 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 8
+  },
+  "vae_backend": "mlx",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 2.0152519999537617
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-all-product/native-b8.png",
+  "png_sha256": "57a85569ad45d469b191470541e8cfff8d576fed6cc6bb8bd54db16e9bd2d81f"
+}

comparisons/optimization-v2/decoder-all-product/trials.json

@@ -0,0 +1,132 @@
+{
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "scope": "Same final latent, decoder-only hot latency",
+  "trials": [
+    {
+      "variant": "native-b1",
+      "median_ms": 3125.603290973231,
+      "min_ms": 3125.603290973231,
+      "max_ms": 3125.603290973231,
+      "samples_ms": [
+        3125.603290973231
+      ],
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0
+    },
+    {
+      "variant": "native-b4",
+      "median_ms": 2132.5830419082195,
+      "min_ms": 2132.5830419082195,
+      "max_ms": 2132.5830419082195,
+      "samples_ms": [
+        2132.5830419082195
+      ],
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0
+    },
+    {
+      "variant": "compiled-b4",
+      "median_ms": 1557.951333001256,
+      "min_ms": 1557.951333001256,
+      "max_ms": 1557.951333001256,
+      "samples_ms": [
+        1557.951333001256
+      ],
+      "pixel_identical": true,
+      "mae_8bit": 0.0,
+      "max_error_8bit": 0,
+      "psnr_db": null,
+      "ssim_rgb": 1.0
+    },
+    {
+      "variant": "native-b8",
+      "median_ms": 2015.2519999537617,
+      "min_ms": 2015.2519999537617,
+      "max_ms": 2015.2519999537617,
+      "samples_ms": [
+        2015.2519999537617
+      ],
+      "pixel_identical": false,
+      "mae_8bit": 0.1251803239186605,
+      "max_error_8bit": 4,
+      "psnr_db": 56.9881575908215,
+      "ssim_rgb": 0.9989046120633382
+    },
+    {
+      "variant": "compiled-b8",
+      "median_ms": 1530.723667005077,
+      "min_ms": 1530.723667005077,
+      "max_ms": 1530.723667005077,
+      "samples_ms": [
+        1530.723667005077
+      ],
+      "pixel_identical": false,
+      "mae_8bit": 0.1251803239186605,
+      "max_error_8bit": 4,
+      "psnr_db": 56.9881575908215,
+      "ssim_rgb": 0.9989046120633382
+    },
+    {
+      "variant": "coreml-CPU_ONLY",
+      "median_ms": 11089.322166983038,
+      "min_ms": 11089.322166983038,
+      "max_ms": 11089.322166983038,
+      "samples_ms": [
+        11089.322166983038
+      ],
+      "pixel_identical": false,
+      "mae_8bit": 0.4373479684193929,
+      "max_error_8bit": 9,
+      "psnr_db": 50.89646445204675,
+      "ssim_rgb": 0.9957860092520554
+    },
+    {
+      "variant": "coreml-CPU_AND_GPU",
+      "median_ms": 2221.881916979328,
+      "min_ms": 2221.881916979328,
+      "max_ms": 2221.881916979328,
+      "samples_ms": [
+        2221.881916979328
+      ],
+      "pixel_identical": false,
+      "mae_8bit": 0.2054581642150879,
+      "max_error_8bit": 7,
+      "psnr_db": 54.674052201530415,
+      "ssim_rgb": 0.9983190643001968
+    },
+    {
+      "variant": "coreml-CPU_AND_NE",
+      "median_ms": 7746.493499958888,
+      "min_ms": 7746.493499958888,
+      "max_ms": 7746.493499958888,
+      "samples_ms": [
+        7746.493499958888
+      ],
+      "pixel_identical": false,
+      "mae_8bit": 24.426151911417644,
+      "max_error_8bit": 255,
+      "psnr_db": 14.66893789509745,
+      "ssim_rgb": 0.49229784661575254
+    },
+    {
+      "variant": "coreml-ALL",
+      "median_ms": 2028.3647498581558,
+      "min_ms": 2028.3647498581558,
+      "max_ms": 2028.3647498581558,
+      "samples_ms": [
+        2028.3647498581558
+      ],
+      "pixel_identical": false,
+      "mae_8bit": 0.2054581642150879,
+      "max_error_8bit": 7,
+      "psnr_db": 54.674052201530415,
+      "ssim_rgb": 0.9983190643001968
+    }
+  ]
+}

comparisons/optimization-v2/decoder-ane-b1/compiled-b4.json

@@ -0,0 +1,72 @@
+{
+  "prompt": "Square editorial studio photograph of a dark cobalt glass perfume bottle on pale travertine. The centered cream label reads exactly 'NIGHT TIDE' in large engraved serif letters and 'EAU DE PARFUM' in small capitals beneath. Dappled blue caustics, crisp glass edges, fine pores in the stone, dark reflections through the translucent bottle, restrained palette and generous negative space. No other text.",
+  "seed": 731,
+  "size": [
+    2048,
+    2048
+  ],
+  "canvas": [
+    2048,
+    2048
+  ],
+  "rng": "torch",
+  "reference_images": [],
+  "reference_sha256": [],
+  "sigmas": [
+    1.0,
+    0.9675236940383911,
+    0.8875485062599182,
+    0.75,
+    0.5327739119529724,
+    0.23200887441635132,
+    0.0
+  ],
+  "steps": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+  ],
+  "vae": {
+    "tile_batch": 4,
+    "compile_blocks": true
+  },
+  "vae_backend": "mlx",
+  "environment": {
+    "platform": "macOS-27.0.1-arm64-arm-64bit",
+    "machine": "arm64",
+    "metal": {
+      "device_name": "Apple M5 Pro",
+      "max_recommended_working_set_size": 55662788608,
+      "memory_size": 68719476736,
+      "architecture": "applegpu_g17s",
+      "max_buffer_length": 41747087360,
+      "resource_limit": 499000
+    },
+    "versions": {
+      "mlx": "0.32.4",
+      "mlx-metal": "0.32.4",
+      "numpy": "2.5.4",
+      "safetensors": "0.8.0",
+      "transformers": "4.57.6",
+      "torch": "2.15.0",
+      "Pillow": "13.0.0",
+      "scikit-image": "0.26.0"
+    },
+    "precision_environment": {
+      "MLX_ENABLE_TF32": "0",
+      "MLX_CONV_WINOGRAD": "0"
+    }
+  },
+  "validation_scope": "Same final latent; decoder only",
+  "timing_scope": "Warm decoder only; model loading excluded",
+  "timings": {
+    "decode_s": 1.5069015838671476
+  },
+  "source_trace": "outputs/suite/product/native-3.trace.safetensors",
+  "source_trace_sha256": "40440f8bf2c8f2ab3cbb454ccc9416062b9d69718aa6a0ef9baf1268037b9a29",
+  "output": "comparisons/optimization-v2/decoder-ane-b1/compiled-b4.png",
+  "png_sha256": "63684ef8ae148a35ddef02650c6aa30b4843b47c99b06cec2ea3708ef3fc2293"
+}