Release Hi3D v1.0 model weights and documentation

AUTHORS

@@ -0,0 +1,26 @@
+SPARC3D authors and contributors
+================================
+
+Sparc3D: Sparse Representation and Construction for High-Resolution 3D Shapes
+Modeling — https://arxiv.org/abs/2505.14521
+
+Paper authors
+-------------
+
+  Zhihao Li
+  Yufei Wang
+  Heliang Zheng
+  Yihao Luo
+  Bihan Wen
+
+Component credits
+-----------------
+
+Named here because the credit belongs with the code, not only with the paper.
+
+  Zhihao Li     GPU surface voxelization in sparc3d/ops, originally written as
+                the pytorch-voxelization extension and implemented as Triton
+                kernels for this release.
+
+Third-party code redistributed with this package is credited separately in
+NOTICE and THIRD_PARTY_LICENSES.md.

LICENSE

@@ -0,0 +1,223 @@
+# Hi3D Open License Agreement Version 1.0
+
+| Item | Details |
+| --- | --- |
+| Licensor | OCEANO HK HOLDING LIMITED |
+| Licensed Project | Hi3D V1.0 |
+| Version | Version 1.0 |
+| Date | October 22, 2026 |
+
+
+
+IMPORTANT NOTICE: By downloading, accessing, using, reproducing, modifying, distributing, displaying or otherwise exercising any rights in the Hi3D Materials, you acknowledge that you have read, understood and agreed to this Agreement. If you do not agree to this Agreement, do not use the Hi3D Materials.
+
+# 1 Definitions
+
+For purposes of this Agreement, the following terms have the meanings set out below.
+
+## 1.1 Agreement
+
+"Agreement" means this Hi3D Open License Agreement Version 1.0 issued with the applicable version of the Hi3D Materials, including Schedule 1, Acceptable Use Policy, and Schedule 2, Licensed Asset Schedule.
+
+## 1.2 Licensor
+
+"Licensor," "we," "us" or "our" means OCEANO HK HOLDING LIMITED, solely to the extent that it owns or is authorized to license the relevant rights in the Hi3D Materials.
+
+## 1.3 You
+
+"You" means the individual or legal entity exercising rights under this Agreement. A "legal entity" includes the entity acting hereunder and any entity that controls, is controlled by, or is under common control with it. "Control" means direct or indirect ownership of more than fifty percent of the voting interests, or the power to direct management.
+
+## 1.4 Hi3D Materials
+
+"Hi3D Materials" means the source code, model architecture, model weights and parameters, inference code, documentation and other materials that are owned by or licensable by the Licensor and expressly identified in the specific release listed in Schedule 2 as being subject to this Agreement. An asset is not automatically included in this Agreement merely because it has a similar name or purpose or is stored in the same repository, unless it has actually been released and is listed in Schedule 2.
+
+## 1.5 Excluded Materials
+
+"Excluded Materials" means third-party software, models, weights and their outputs; training, validation and test datasets; sample media, fonts and other third-party assets; first-stage systems or server-side code not listed in Schedule 2; trademarks and brand assets except as expressly permitted under Section 8; and any other items expressly subject to separate terms. Excluded Materials are not licensed under this Agreement. Sample code calling a third-party model does not alter the licensing status of that third-party model or its outputs.
+
+## 1.6 Model Derivative
+
+"Model Derivative" means another machine-learning model created by modifying, fine-tuning, adapting or quantizing all or a substantial part of the Hi3D model weights or parameters, or otherwise based on or incorporating the foregoing. Standalone Outputs, including generated 3D meshes and model files and finished works created by editing, converting or combining such files, do not become Model Derivatives merely because they were generated or post-processed; however, any portion of a finished work that actually contains Hi3D code, weights or parameters remains subject to this Agreement according to its nature.
+
+## 1.7 Output
+
+"Output" means content or information generated by running the Hi3D Materials or a Model Derivative, including generated 3D geometry, meshes and exported 3D files. Any third-party asset actually contained in an Output remains subject to the applicable third-party rights or separate license.
+
+## 1.8 Commercial Product or Service
+
+"Commercial Product or Service" means any product, service or hosted functionality that uses or contains the Hi3D Materials or a Model Derivative and is offered for commercial advantage, monetary consideration, revenue generation or other material commercial benefit.
+
+## 1.9 Related Product or Service
+
+"Related Product or Service" means a product or service that uses or contains the Hi3D Materials or a Model Derivative. Substantially similar services split among different brands, applications, interfaces, domain names or affiliated entities to evade the Scale Threshold must be aggregated.
+
+## 1.10 Monthly Active Users
+
+"Monthly Active Users" or "MAU" means the number of unique natural persons who actively use a Related Product or Service during a calendar month.
+
+## 1.11 First Stage
+
+"First Stage" means coarse-mesh generation that generates the basic three-dimensional shape of an object from a reference image, determines its principal structure and approximate contours, and outputs a coarse mesh for subsequent processing.
+
+## 1.12 Second Stage
+
+"Second Stage" means geometry refinement that takes a reference image and the coarse mesh produced by the First Stage as inputs, progressively refines the three-dimensional shape, and generates higher-resolution three-dimensional geometry and mesh files.
+
+# 2 License Grant
+
+Subject to your continuing compliance with this Agreement, and solely with respect to rights in the Hi3D Materials that the Licensor owns or is authorized to license, the Licensor grants you a worldwide, non-exclusive, royalty-free license to use, reproduce, modify, fine-tune and adapt the Hi3D Materials in source-code, object-code, weight or other applicable form; create Model Derivatives and other derivative works; publicly display and publicly perform them; and distribute, sublicense and sell the Hi3D Materials. You may also deploy the Hi3D Materials on servers, cloud platforms or other computing environments that you control or lawfully use, and provide third parties with hosted services based on the Hi3D Materials through websites, applications, application programming interfaces (APIs), software as a service (SaaS) or other remote-access methods. This license may be transferred only through sublicensing or distribution that complies with this Agreement.
+
+## 2.1 Commercial Use
+
+Commercial use is permitted subject to Sections 5, 6, 7 and 8. No revenue threshold applies separately from Section 5.
+
+## 2.2 Training Other AI Models
+
+To the extent the Licensor has the right to grant such permission, you may use the Hi3D Materials and their Outputs to train, evaluate, improve or develop other artificial-intelligence or machine-learning models, subject to applicable law, third-party rights and Schedule 1. This permission does not extend to coarse models, outputs or other third-party materials generated through third-party models, and does not replace their separate license terms. Another model is a Model Derivative only if it satisfies the definition in Section 1.6.
+
+# 3 Patent License
+
+Subject to your compliance with this Agreement, and solely with respect to patent claims that the Licensor owns or is authorized to license and that are necessarily infringed by implementation of the Hi3D Materials, the Licensor grants you a perpetual, worldwide, non-exclusive, royalty-free patent license to make, have made, use, offer for sale, sell, import and otherwise transfer the Hi3D Materials. A patent license from any other contributor arises only if that contributor has the right to grant it and expressly agrees to provide it under this Agreement.
+
+## 3.1 Patent Litigation
+
+If you institute patent litigation against the Licensor or any contributor alleging that the Hi3D Materials or a contribution directly or contributorily infringes a patent, all patent licenses granted to you under this Agreement for the Hi3D Materials terminate as of the date the claim is filed.
+
+# 4 Distribution and Sublicensing Conditions
+
+You may distribute the Hi3D Materials and Model Derivatives, including as part of a proprietary or closed-source product, only if you comply with all of the following conditions. Merely reproducing, editing, displaying, selling or distributing Outputs that do not contain Hi3D Materials or Model Derivatives is not distribution under this Section, and does not by itself require those Outputs to be accompanied by this Agreement, a NOTICE file or a modification notice.
+
+- Provide each recipient of files containing the Hi3D Materials or a Model Derivative with the full text of this Agreement upon delivery, or a link that provides continuous, free access to the full text of the corresponding version of this Agreement.
+- Retain all applicable copyright, patent and attribution notices contained in the Hi3D Materials.
+- Prominently identify the files, weights or materials that you modified.
+- When distributing files containing the Hi3D Materials or a Model Derivative, include a readable NOTICE file containing the notice specified in Section 8.2 and all applicable original third-party notices and license requirements.
+- Ensure that your terms do not restrict recipients from exercising the rights granted under this Agreement in unmodified portions of the Hi3D Materials, and pass the Acceptable Use Policy downstream as an enforceable condition.
+
+## 4.1 Licensing of Model Derivatives
+
+You may apply different terms, including proprietary terms, to your own modifications and to a Model Derivative as a whole; however, the portions that actually reproduce or embed Hi3D code, weights or parameters remain subject to this Agreement, and the applicable attribution, branding, scale and use conditions continue to apply. A finished 3D work containing only Outputs and not the foregoing Hi3D Materials is not subject to this subsection's conditions for Model Derivatives merely because it was generated using Hi3D.
+
+# 5 Scale Threshold and Separate License
+
+The Scale Threshold is triggered if one or more Related Products or Services exceed 200,000 Monthly Active Users in the most recent complete calendar month or generate monthly revenue of at least USD 1,000,000. Except for the anti-circumvention aggregation rule in Section 1.9, only Related Products or Services are counted.
+
+## 5.1 Application
+
+Within sixty days after first triggering the Scale Threshold, you must notify OCEANO HK HOLDING LIMITED and apply for a separate written license. The application must truthfully disclose the applicant, the affected products and services, the MAU calculation methodology, use cases, deployment regions, security measures and any other information reasonably requested by us.
+
+## 5.2 Transition Period
+
+If you submit a complete, truthful and timely application and remain compliant, you may continue your existing use during the sixty-day application period and while both parties are actively negotiating in good faith; however, without our written consent, you may not materially expand the affected use beyond its scale and scope when the Scale Threshold was first exceeded.
+
+## 5.3 Decision on Separate License
+
+A separate license may include fees, branding, reporting, audit, security, service-level or other commercial terms. We may decide, in our sole discretion, whether to grant or deny a separate license. No separate license is effective unless signed by an authorized representative of OCEANO HK HOLDING LIMITED or otherwise expressly confirmed by it in writing.
+
+## 5.4 Failure to Obtain a License
+
+If you fail to apply within the required period, make a materially false statement in an application, or continue the affected use after written denial or after good-faith negotiations end without agreement, your right to continue above-threshold use terminates. Any continuing above-threshold use is unauthorized and constitutes a material breach.
+
+# 6 Acceptable Use Policy
+
+Your use of the Hi3D Materials and Model Derivatives, and your conduct in generating Outputs with them, must comply with Schedule 1, applicable law and third-party rights. This Agreement does not otherwise restrict the ordinary reproduction, editing, display, sale or distribution of Outputs that have been generated and do not contain Hi3D Materials or Model Derivatives; you remain responsible for complying with applicable law and any third-party rights contained in the Outputs. You may not knowingly assist another person in circumventing restrictions on the use of the Hi3D Materials or Model Derivatives.
+
+## 6.1 Policy Version
+
+The version of Schedule 1 accompanying the Hi3D version you receive applies to that version. We may issue a revised policy for later versions. Material revisions do not apply retroactively to prior versions unless you expressly accept them.
+
+# 7 Commercial Branding Display
+
+Any entity integrating the Hi3D Materials or a Model Derivative into a Commercial Product or Service must display "Powered by Hi3D 1.0" clearly and with reasonable prominence. A product with a user interface must display it in the interface, on an About page or in product acknowledgements. An API, SDK, backend or embedded product without a conventional user interface must display it in primary customer-accessible technical documentation, a service description or a legal notice. Where the display location supports a clickable link, the text must link to the official Hi3D website listed in Schedule 2; if a link cannot be provided, the official website address must be stated in the same location or related documentation. Merely obtaining or using a generated 3D Output file does not, by itself, create the branding-display obligation under this Section.
+
+You may use the Licensor's commercial marks only to comply with the branding-display obligation under this Section. This permission may be revoked at any time and does not transfer any rights or constitute the Licensor's endorsement of you or any related product or service. The Licensor may require you in writing to cease using or remove the relevant marks, and you must do so within five (5) business days after receiving the notice. Once the marks have been removed, you will no longer be subject to the corresponding branding-display obligation.
+
+## 7.1 No Endorsement
+
+Unless we expressly agree in writing, you may not state or imply that your product, service, Model Derivative or Output was created, certified, endorsed or supported by OCEANO HK HOLDING LIMITED, or is an official Hi3D product.
+
+# 8 Trademarks and Notices
+
+Except for the limited license below, this Agreement grants no right to use the names, logos, trade dress, domain names or trademarks of OCEANO HK HOLDING LIMITED, Hi3D or their affiliates. Reasonable descriptive use to identify the source of the Hi3D Materials is permitted.
+
+## 8.1 Limited Mark License
+
+While you remain in compliance with this Agreement, we grant you a limited, non-exclusive, non-transferable and non-sublicensable license to use the "Hi3D" word mark only to the extent necessary to comply with Sections 4 and 7. This license terminates when your right to use the relevant Hi3D Materials terminates under Section 14. It does not include use of any logo or any use that implies endorsement, sponsorship or official status. All goodwill belongs to the applicable trademark owner.
+
+## 8.2 Required Notice
+
+The NOTICE file must state: "Hi3D is licensed under the Hi3D Open License Agreement Version 1.0. Copyright © 2026 OCEANO HK HOLDING LIMITED. All rights not expressly granted are reserved. The Hi3D trademarks are owned by OCEANO HK HOLDING LIMITED or its applicable affiliate(s)."
+
+# 9 Outputs
+
+As between you and us, we claim no ownership of Outputs generated by you. So long as an Output itself does not contain Hi3D Materials or a Model Derivative, you and downstream users who obtain that Output may reproduce, edit, display, sell and distribute it without being required, solely because of that use, to display "Powered by Hi3D 1.0," include this Agreement or a NOTICE file, or apply for a scale-based license under Section 5. This Section does not transfer rights and does not guarantee that an Output is copyrightable, original or non-infringing. Any applicable terms governing third-party models, inputs, materials or services must still be observed.
+
+# 10 Third-Party Materials
+
+Third-party software, models, weights and their outputs remain subject to their respective licenses and terms of use, and you are responsible for independently obtaining and complying with the relevant rights. Sample code included with this release may call Hunyuan3D-2mini to generate a first-stage coarse model, but Hi3D does not license that model's software, weights or outputs under this Agreement; the model version, source and license used by the sample must be identified in the release documentation. Other external models loaded for second-stage inference, and their actual versions, must also be listed in the third-party dependency schedule. Unless expressly stated otherwise, this Agreement does not license training data, sample media, fonts, datasets or other Excluded Materials.
+
+# 11 Disclaimer
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE HI3D MATERIALS, MODEL DERIVATIVES, OUTPUTS AND ALL RELATED RIGHTS ARE PROVIDED "AS IS" AND "AS AVAILABLE," WITHOUT WARRANTIES OF ANY KIND, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, ACCURACY, SECURITY, RELIABILITY OR UNINTERRUPTED OPERATION. YOU ARE RESPONSIBLE FOR DETERMINING WHETHER YOUR USE IS APPROPRIATE AND LAWFUL.
+
+# 12 Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, OCEANO HK HOLDING LIMITED, ITS AFFILIATES AND CONTRIBUTORS WILL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, PUNITIVE OR CONSEQUENTIAL DAMAGES, OR FOR ANY LOSS OF PROFITS, REVENUE, DATA OR GOODWILL, OR BUSINESS INTERRUPTION, ARISING FROM THIS AGREEMENT OR THE HI3D MATERIALS, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH LOSS. LIABILITY THAT CANNOT LAWFULLY BE EXCLUDED IS NOT EXCLUDED BY THIS SECTION.
+
+# 13 Indemnification
+
+You will, to the applicable extent, defend, indemnify and hold harmless OCEANO HK HOLDING LIMITED, its affiliates, officers, employees and contributors from and against third-party claims, losses, liabilities, damages, judgments, costs and reasonable legal fees arising from your breach of this Agreement; unlawful use; inputs; Outputs; modifications; Model Derivatives; products; services; or distribution. We will promptly notify you of a claim and, at your expense, provide reasonable assistance and permit you to control the defense and settlement; however, without the indemnified party's prior written consent, you may not admit liability on its behalf, impose obligations on it or agree to non-monetary relief against it.
+
+# 14 Term and Termination
+
+This Agreement takes effect when you first access the Hi3D Materials or exercise the relevant rights, and continues until terminated. Upon a material breach, your rights terminate immediately following our written notice. For any other breach, your rights terminate if you fail to cure within thirty days after our written notice. Patent termination under Section 3.1 and scale-based termination under Section 5.4 operate according to their respective terms.
+
+## 14.1 Effect of Termination
+
+Upon termination, you must cease any use no longer authorized under this Agreement and delete any Hi3D model weights and other Hi3D Materials in your possession or control that are required to be deleted. Records required by law and routine backups that cannot be immediately purged must not be used and must be deleted in accordance with the applicable retention period. Termination does not automatically terminate licenses lawfully granted before termination where downstream recipients remain compliant, but you may make no new distributions. Sections 1 and 7 through 16, and accrued rights, survive to the extent applicable.
+
+# 15 Governing Law and Arbitration
+
+This Agreement and any non-contractual obligations arising from it are governed by the laws of the Hong Kong Special Administrative Region, without regard to conflict-of-laws rules. Any dispute arising out of or relating to this Agreement will be finally resolved by arbitration administered by the Hong Kong International Arbitration Centre under the HKIAC Administered Arbitration Rules in force when the Notice of Arbitration is submitted. The seat of arbitration is Hong Kong, the tribunal will consist of one arbitrator, and the language of arbitration is English. Either party may seek urgent interim or injunctive relief from a court of competent jurisdiction.
+
+# 16 General
+
+This Agreement constitutes the entire agreement concerning this public license. To the extent a separate written commercial license expressly addresses a matter and conflicts with this Agreement, the commercial license controls. If any provision is unenforceable, it will be adjusted only to the minimum extent necessary and the remainder will remain in effect. Failure to enforce a right is not a waiver. Headings and translations do not affect the meaning of the terms. Except for a permitted transfer with a related product or business where the transferee accepts this Agreement, you may not assign this Agreement.
+
+## 16.1 Non-Retroactive Updates
+
+The license text accompanying the version of the Hi3D Materials you receive continues to apply to that version. We may license later versions under revised terms, but revisions do not retroactively alter rights already granted for earlier versions.
+
+## 16.2 Contact
+
+Applications for scale-based licenses and legal notices must be submitted using the contact details published on the official Hi3D release page, or sent to another address formally designated by OCEANO HK HOLDING LIMITED.
+
+# Schedule 1  Acceptable Use Policy
+
+You may not use the Hi3D Materials or Model Derivatives for any of the following activities, or generate or disseminate the prohibited content listed below through such use. This Schedule does not impose model-use obligations on a person merely because that person obtains or ordinarily uses a generated 3D finished work that does not contain Hi3D Materials or a Model Derivative; subsequent use of such a finished work remains subject to applicable law and third-party rights.
+
+- Violate applicable law, sanctions, export controls, court orders or binding regulatory requirements;
+- Infringe or misappropriate copyright, patent rights, trademark rights, trade secrets, privacy, data protection, publicity rights, image rights or other rights;
+- Exploit, sexualize, groom or traffic minors, or otherwise harm minors;
+- Create, distribute or facilitate malware, ransomware, unauthorized access, credential theft, destructive code or material network abuse;
+- Deceptively impersonate another person, commit fraud, manipulate identity, or generate deceptive synthetic media without disclosure where disclosure is required by law;
+- Intentionally facilitate violence, terrorism, self-harm, unlawful discrimination, stalking, harassment or targeted abuse;
+- Unlawfully collect, infer, disclose or use personal or sensitive information, or undertake any of those activities for the purpose of harming another person;
+- Circumvent technical safeguards or access controls in the Hi3D Materials, except for authorized good-faith security research conducted with appropriate safeguards;
+- Make fully automated decisions in healthcare, employment, credit, housing, education, insurance, law enforcement or essential services that have legal or similarly significant effects, without legally required human oversight, testing, notice and appeal mechanisms; or
+- Falsely represent a Model Derivative or product as an official Hi3D version or as endorsed by OCEANO HK HOLDING LIMITED.
+
+This Policy does not prohibit lawful research, testing, auditing, red-teaming or development conducted with reasonable safeguards and not deployed for a prohibited purpose.
+
+# Schedule 2  Licensed Asset Schedule
+
+This Schedule identifies the assets in this release that are subject to the Hi3D Open License Agreement Version 1.0. The second-stage inference code, documentation and configuration listed below as "Included," together with the eight second-stage model files identified below for distribution under the name Hi3D v1.0 in the Hugging Face model repository at https://huggingface.co/hi3d-official/Hi3Dv1.0, are included under this Agreement to the extent the Licensor owns or is authorized to license them. Inclusion is not affected by the code and weights being stored separately on GitHub and Hugging Face. No third-party model, external dependency, unreleased first-stage material or file listed as "Excluded" is licensed under this Agreement.
+
+| Item | Details |
+| --- | --- |
+| Code Release (Basis of Included Scope) | The Hi3D v1.0 source release at https://github.com/hi3d-official/Hi3Dv1.0 containing this Agreement. The included code, documentation and configuration are identified by the paths below. This Schedule applies to the files accompanying this version of the Agreement, not automatically to later repository versions. |
+| Second-Stage Inference Code and Architecture (Included) | Under sparc3d/: models/, nn/, ops/, pipelines/, schedulers/, sparcubes/, structures/, utils/ and package initialization files; demo/refine_mesh.py, demo/image_to_mesh.py and demo/coarse_stage.py. Coverage is limited to implementations and modifications that the Licensor is authorized to license. coarse_stage.py is sample adapter code that calls an external Hunyuan model and does not include the Hunyuan code or weights. |
+| Second-Stage Model Weights and Configuration (Included) | The following eight Hi3D v1.0 files are included under this Agreement at paths relative to the root of the Hugging Face model repository: model_index.json; scheduler/scheduler_config.json; transformer_512/config.json; transformer_512/model.safetensors (3,675,679,280 bytes); transformer_1024/config.json; transformer_1024/model.safetensors (3,675,679,280 bytes); vae/config.json; and vae/model.safetensors (376,629,712 bytes). transformer_1024/model.safetensors is used for both the 1024³ and 1536³ settings; there is no separate transformer_1536 weight in this release. The designated release location for these files is https://huggingface.co/hi3d-official/Hi3Dv1.0. This item excludes all other files in that repository and also excludes external models and weights such as Hunyuan3D-2mini, DINOv2 and CLIP. |
+| Documentation and Configuration (Included to the Extent Licensable) | README.md, README.zh-CN.md, docs/installation.md, docs/pipeline.md and docs/reproduction.md, together with content in pyproject.toml, MANIFEST.in, docker/Dockerfile and docker/constraints.txt that the Licensor is authorized to license. Original notices in AUTHORS, NOTICE, THIRD_PARTY_LICENSES.md and third-party license files must be preserved unchanged. |
+| Sample Media (Excluded) | assets/example.png, assets/framework.png, assets/global-comparison-1.jpg, assets/global-comparison-2.jpg and assets/local-detail-comparison.jpg are excluded. Their presence in this release does not grant any license to use them under this Agreement. Any use is subject to the applicable rights and separate permissions. |
+| Unreleased and Third-Party Materials (Excluded) | Unreleased proprietary Hi3D first-stage materials, training code and datasets; original third-party rights in TRELLIS, Pointcept, O-CNN and FlexiCubes; Hunyuan3D-2mini code, weights and outputs called externally by the sample; and the facebook/dinov2-large and openai/clip-vit-large-patch14 weights separately obtained at runtime are not sublicensed under this Hi3D Agreement. Original third-party notices and their respective terms continue to apply. |
+| Official Hi3D Websites | The link target for "Powered by Hi3D 1.0" under Section 7 is http://hi3d.ai/. The China website is https://www.hi3d.cn/. |

NOTICE

@@ -0,0 +1,49 @@
+SPARC3D
+Copyright 2026 The SPARC3D Authors
+
+This product includes software developed by third parties. The following
+components are redistributed under their own licenses, reproduced in full in
+THIRD_PARTY_LICENSES.md:
+
+  * Microsoft TRELLIS (MIT License)
+    Copyright (c) Microsoft Corporation.
+    https://github.com/microsoft/TRELLIS
+
+  * Pointcept / Point Transformer V3 (MIT License)
+    Copyright (c) 2023 Pointcept
+    https://github.com/Pointcept/Pointcept
+
+  * O-CNN, ocnn-pytorch (MIT License)
+    Copyright (c) 2022 Peng-Shuai Wang <wangps@hotmail.com>
+    https://github.com/octree-nn/ocnn-pytorch
+
+  * NVIDIA FlexiCubes (Apache License 2.0)
+    Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES
+    https://github.com/nv-tlabs/FlexiCubes
+    License also included at sparc3d/ops/flexicubes/LICENSE.txt
+
+GPU surface voxelization in sparc3d/ops descends from the PyTorch extension
+written by Zhihao Li; see AUTHORS.
+
+
+Hi3D v1.0
+---------
+Hi3D v1.0 includes the SPARC3D inference implementation. Original copyright,
+attribution, license texts, and per-file modification notices are retained.
+The Python package and API names are sparc3d / Sparc3DPipeline.
+
+Hunyuan3D is referenced only by an optional coarse-mesh example adapter. Tencent's
+Hunyuan3D implementation and weights are not bundled with or relicensed by this
+distribution. External image encoders and any separately obtained model weights
+retain their own terms. See THIRD_PARTY_LICENSES.md for the source and model
+license index.
+
+
+Hi3D Open License Agreement Version 1.0 notice
+--------------------------------------------
+The following notice applies to the Hi3D Materials identified in Schedule 2 of
+LICENSE, only to the extent OCEANO HK HOLDING LIMITED owns or is authorized to
+license them. It does not replace the original third-party notices above or
+extend the Agreement to Excluded Materials. See THIRD_PARTY_LICENSES.md.
+
+Hi3D is licensed under the Hi3D Open License Agreement Version 1.0. Copyright © 2026 OCEANO HK HOLDING LIMITED. All rights not expressly granted are reserved. The Hi3D trademarks are owned by OCEANO HK HOLDING LIMITED or its applicable affiliate(s).

README.md

@@ -7,6 +7,9 @@ tags:
   - geometry-refinement
   - sparc3d
   - image-to-3d
+license: other
+license_name: hi3d-open-license-agreement-1.0
+license_link: LICENSE
 ---
 
 # Hi3D v1.0
@@ -17,29 +20,29 @@ tags:
 
 **[Live Demo](https://huggingface.co/spaces/ilcve21/Sparc3D)** · [GitHub Repository](https://github.com/hi3d-official/Hi3Dv1.0) · [International Website](http://hi3d.ai/) · [China Website](https://www.hi3d.cn/)
 
-Planned open-source release: October 23, 2026.
-
-This Hugging Face repository mirrors the [official GitHub project preview](https://github.com/hi3d-official/Hi3Dv1.0). It contains project documentation, the system overview, and selected visual comparisons. No source code or model weights are included yet.
+Released on October 23, 2026.
 
 ## Overview
 
-Hi3D v1.0 is the official Hi3D project for high-resolution 3D geometry refinement. Built upon the Sparc3D geometry pipeline, it uses a reference image together with a coarse mesh to refine object geometry through successive sparse reconstruction levels.
+Hi3D v1.0 refines a coarse mesh into high-resolution geometry, conditioned on a reference image of the same object. Built upon the Sparc3D representation and refinement architecture, it progressively samples sparse latents, decodes them with a self-pruning sparse VAE, and extracts a mesh.
+
+The project report describes training on approximately **two million curated 3D assets** and refinement up to an effective sparse extraction-grid resolution of **1536³**. The Python package and public API retain the names `sparc3d` and `Sparc3DPipeline` for compatibility.
 
-The project report describes training on approximately **two million curated 3D assets** and refinement up to an effective sparse extraction-grid resolution of **1536³**. Hi3D v1.0 retains the Sparc3D representation and refinement architecture, with an emphasis on scaling training data and high-resolution geometry.
+This repository provides the **Hi3D v1.0 refinement model artifacts**. Inference code is available in the [GitHub repository](https://github.com/hi3d-official/Hi3Dv1.0). Training code and the paper's evaluation harness are not included. Model artifacts are available on [Hugging Face](https://huggingface.co/hi3d-official/Hi3Dv1.0). The examples load `hi3d-official/Hi3Dv1.0` directly; a compatible local model directory is also supported.
 
 ## System overview
 
 [![Hi3D v1.0 system overview: reference image and coarse mesh, sparse refinement, and three mesh extraction levels](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/framework.png)](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/framework.png)
 
-Image features condition sparse flow on coordinates derived from the coarse geometry. A self-pruning sparse VAE decoder expands the features around predicted surfaces, followed by mesh extraction. Between levels, the extracted mesh is revoxelized to provide the next sparse support.
+Image features condition sparse flow on coordinates derived from the coarse geometry. After decoding and mesh extraction, the mesh is revoxelized to provide the sparse support for the next pass.
 
-| Level | Nominal structural grid | Sparse extraction grid |
-| --- | --- | --- |
-| 1 | 64³ | 512³ |
-| 2 | 128³ | 1024³ |
-| 3 | 192³ | 1536³ |
+| Pass | Nominal structural grid | Sparse extraction grid | Transformer |
+| --- | --- | --- | --- |
+| 1 | 64³ | 512³ | `transformer_512` |
+| 2 | 128³ | 1024³ | `transformer_1024` |
+| 3 | 192³ | 1536³ | `transformer_1024` |
 
-These labels describe nominal sparse coordinate and surface-extraction resolutions. They do not represent a dense 1536³ latent tensor or a fixed output triangle count.
+A 512³ request runs one pass; 1024³ runs two; 1536³ runs all three. These labels describe nominal sparse coordinate and extraction grids, rather than a dense 1536³ latent tensor or a fixed triangle count. See [pipeline details](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/pipeline.md).
 
 ## Visual comparisons
 
@@ -53,25 +56,170 @@ Red boxes mark the reference regions enlarged in each row. Shaded geometry and c
 
 [![Multi-view geometry comparisons for a vehicle, armored character, armchair, and handbag](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-1.jpg)](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-1.jpg)
 
-Front, back, and bottom views are shown for four objects. Results combine shaded geometry and colored surface-normal renderings; the color does not represent generated textures. Hi3D v1.0 is highlighted in teal.
+Four objects are shown from the front, back, and bottom. Results combine shaded geometry and colored surface-normal renderings; the color does not represent generated textures. Hidden views illustrate plausible completion, rather than exact reconstruction of unseen surfaces.
 
 <details>
 <summary>More multi-view examples</summary>
 
 [![Additional multi-view examples for a humanoid bust, mechanical robots, and a stylized character](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-2.jpg)](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-2.jpg)
 
-Additional examples follow the same column order and rendering conventions as the preceding figure.
+Additional examples follow the same column order and rendering conventions as the preceding figure. Hi3D v1.0 remains the teal-highlighted rightmost column.
 
 </details>
 
-## Scope and limitations
+## Installation
+
+Requirements: **Linux, Python 3.10, an NVIDIA GPU with compute capability 8.0 or newer, and a CUDA toolkit in the 12.0–12.5 range** matching the installed PyTorch build. There is no CPU inference path. The measured stack used Python 3.10.12, PyTorch 2.5.0+cu124, CUDA toolkit 12.4.131, and a **96 GB NVIDIA H20**. The 1536³ ladder has only been validated on that GPU; peak memory and feasibility on smaller cards have not been established.
+
+Clone this repository, then run from its root in a Python 3.10 environment:
+
+```bash
+git clone https://github.com/hi3d-official/Hi3Dv1.0.git
+cd Hi3Dv1.0
+
+pip install torch==2.5.0+cu124 torchvision==0.20.0+cu124 \
+  --extra-index-url https://download.pytorch.org/whl/cu124
+pip install packaging ninja psutil
+pip install --no-build-isolation flash-attn==2.7.4.post1
+pip install -c docker/constraints.txt -e ".[inference]"
+```
+
+The constraints preserve the measured kernel stack, including `spconv-cu120==2.3.6` and `flash-attn==2.7.4.post1`. Install `flash-attn` separately after PyTorch: its source build needs the installed torch and CUDA toolkit, with build isolation disabled. Triton mesh kernels compile at first use. This project is installed from source; no PyPI release or prebuilt project wheel is supplied.
+
+For background removal in the demos, additionally install `pip install -c docker/constraints.txt -e ".[demo]"`. This extra installs `rembg`, not a coarse generator. See [installation](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/installation.md) for Docker, the complete verified stack, offline setup, and alternative CUDA/kernel builds. Other configurations have not been measured.
+
+## Model artifacts
+
+The [Hugging Face model repository](https://huggingface.co/hi3d-official/Hi3Dv1.0/tree/main) provides these eight runtime files at its root. A local copy must preserve this layout:
+
+```text
+model_index.json
+scheduler/scheduler_config.json
+vae/config.json
+vae/model.safetensors
+transformer_512/config.json
+transformer_512/model.safetensors
+transformer_1024/config.json
+transformer_1024/model.safetensors
+```
+
+The loader consumes JSON and safetensors; it does not execute model-repository Python or unpickle checkpoints. It also accepts a Hugging Face model repository ID with the same artifact layout. Standard Hub loading defers the high-resolution transformer until needed; local directories must contain all files, and enabling sequential CPU offload materializes both transformers on the CPU.
+
+The conditioning encoders, `facebook/dinov2-large` and `openai/clip-vit-large-patch14`, are loaded separately from Hugging Face on first use. They are not part of the model directory above. `--revision` selects the refinement artifact revision; `--cache-dir` points to the directory holding `models--*` trees, normally `$HF_HOME/hub`.
+
+## Python API
+
+```python
+from PIL import Image
+import trimesh
+from sparc3d import Sparc3DPipeline
+
+pipeline = Sparc3DPipeline.from_pretrained(
+    "hi3d-official/Hi3Dv1.0",
+).to("cuda")
+
+result = pipeline(
+    Image.open("input.png"),
+    trimesh.load("coarse.glb", force="mesh", process=False),
+    resolution=1024,
+    num_inference_steps=25,
+    seed=0,
+)
+result.mesh.export("refined.glb")
+```
+
+`result` is a `Sparc3DPipelineOutput` containing a geometry-only `trimesh.Trimesh` and the achieved `resolution`. Supported resolutions are **512, 1024, and 1536**, with 25 scheduler updates per pass by default. Supply `seed` or a local CPU `torch.Generator`, not both. For existing unique integer voxel coordinates shaped `[N, 3]`, the API also provides `pipeline.refine_voxels(image, voxel_coords, structure_resolution=64, resolution=1536, seed=0)`.
+
+### Memory offload and progress
+
+To reduce model residency on the GPU, enable Accelerate offload while the pipeline is still on the CPU:
+
+```python
+pipeline = Sparc3DPipeline.from_pretrained("hi3d-official/Hi3Dv1.0")
+pipeline.enable_sequential_cpu_offload("cuda")
+```
+
+Use this instead of `.to("cuda")`; the two modes cannot be combined. Offload does not establish a minimum supported GPU memory size and does not eliminate decoded-feature memory costs.
+
+Pass `progress_callback` to `from_pretrained` to receive a `Sparc3DProgressEvent` after every scheduler update:
+
+```python
+def report(event):
+    print(f"pass {event.pass_index + 1}/{event.num_passes} "
+          f"step {event.step}/{event.num_inference_steps}")
+
+pipeline = Sparc3DPipeline.from_pretrained(
+    "hi3d-official/Hi3Dv1.0", progress_callback=report,
+).to("cuda")
+```
+
+Decoding, extraction, and postprocessing do not emit scheduler progress events.
+
+## Command line
+
+Refine an existing coarse mesh without any Hunyuan dependency:
+
+```bash
+python demo/refine_mesh.py \
+  --model hi3d-official/Hi3Dv1.0 \
+  --image input.png --coarse-mesh coarse.glb --output refined.glb \
+  --resolution 1024 --num-inference-steps 25 --seed 0
+```
+
+Add `--sequential-cpu-offload` for model offload, or `--remove-background` after installing the demo extra. Background removal is opt-in; transparent cut-out inputs retain their alpha for subject framing.
+
+For offline refinement, provide local copies of all three model components:
+
+```bash
+python demo/refine_mesh.py \
+  --model /path/to/hi3d-v1.0-model \
+  --image input.png --coarse-mesh coarse.glb --output refined.glb \
+  --local-files-only \
+  --dino-model /path/to/dinov2-large \
+  --clip-model /path/to/clip-vit-large-patch14
+```
+
+## Optional Hunyuan coarse-generation example
+
+`demo/coarse_stage.py` is an optional adapter for **Hunyuan3D-2 mini**, using `tencent/Hunyuan3D-2mini` and its `hunyuan3d-dit-v2-mini-turbo` subfolder. `demo/image_to_mesh.py` calls this adapter before refinement. Hunyuan is used only to demonstrate an upstream coarse generator; it is neither a required dependency of the core library nor a required product integration. You can replace the adapter or supply your own coarse mesh to `demo/refine_mesh.py`, which has no Hunyuan import.
+
+Install the [Hunyuan3D-2 code](https://github.com/Tencent-Hunyuan/Hunyuan3D-2) and obtain its weights separately before running:
+
+```bash
+python demo/image_to_mesh.py \
+  --model hi3d-official/Hi3Dv1.0 \
+  --image assets/example.png --output refined.glb \
+  --resolution 1024 --seed 0
+```
+
+The Hunyuan code and weights are third-party releases, not code or weights released or relicensed by Hi3D. Follow the [upstream source license](https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/LICENSE) and the [Hunyuan3D-2 mini model license](https://huggingface.co/tencent/Hunyuan3D-2mini/blob/main/LICENSE). See [external models and optional examples](THIRD_PARTY_LICENSES.md#external-models-and-optional-examples) and the [coarse-stage installation notes](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/installation.md#the-coarse-stage).
+
+`--coarse-model` and `--coarse-subfolder` override the coarse model. Offline end-to-end use additionally needs a local Hunyuan model: the refinement flags `--local-files-only`, `--revision`, and `--cache-dir` do not configure the Hunyuan loader.
+
+## Scope and reproducibility
+
+- **Geometry only, batch size one.** No textures, materials, or vertex colors are generated. Output is recentered and normalized to unit maximum radius, so input world coordinates and absolute scale are not preserved.
+- **Coarse structure matters.** Severe structural errors in the coarse mesh can persist. Geometry hidden from the image is a plausible completion.
+- **GPU kernels are required.** `flash-attn` has no fallback attention path. Adaptive voxelization may use a coarser support grid on complex inputs and emits a warning. A request that cannot reach the target resolution raises instead of silently returning a lower resolution.
+- **Seeds are not mesh hashes.** The refinement sampler uses a local CPU RNG, but GPU sparse convolution and attention are not bitwise deterministic. Compare meshes geometrically using the same inputs, artifact, scheduler, and environment.
+- **Inference validation only.** Training code, the evaluation harness, benchmark splits, and comparison meshes are not included; this repository alone cannot reproduce the paper's comparative tables. Geometric detail and nominal resolution do not guarantee fitness for a downstream application.
+
+## Documentation
+
+- [Installation](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/installation.md): verified stack, Docker, offline loading, and GPU dependencies.
+- [Pipeline](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/pipeline.md): refinement passes, conditioning, extraction, and memory behavior.
+- [Reproduction](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/reproduction.md): validation scope and meaningful run-to-run comparisons.
+
+## License and acknowledgments
+
+The Hi3D-owned or authorized portions of the second-stage implementation and modifications, documentation, configuration, and eight model artifact files identified in Schedule 2 are governed by the **[Hi3D Open License Agreement Version 1.0](LICENSE)**. See [license scope](THIRD_PARTY_LICENSES.md#license-scope) for the scope and exclusions; the Agreement controls.
 
-- **Geometry output.** Hi3D v1.0 focuses on geometry; it does not generate textures, materials, or vertex colors.
-- **Coarse-mesh dependency.** An upstream coarse mesh supplies global structure. Severe structural errors in that initialization may persist after refinement.
-- **Occluded regions.** Geometry hidden from the input image is a plausible completion rather than an exact reconstruction of unseen surfaces.
-- **Application-specific validation.** Visual detail and nominal resolution do not by themselves guarantee mesh suitability for a particular downstream workflow.
+- **Commercial use is permitted under the Agreement.** If a related product or service exceeds **200,000 monthly active users** or reaches **USD 1,000,000 in monthly revenue**, notify the Licensor and apply for a separate written license within **60 days**, subject to Section 5 and its aggregation and transition rules.
+- **Commercial integrations must display `Powered by Hi3D 1.0`** as specified in Section 7, linking to the official website identified in Schedule 2 where supported. Distribution and use also remain subject to the Agreement's notice requirements and Acceptable Use Policy.
+- **Standalone outputs have different treatment.** Obtaining, editing, displaying, selling, or distributing an output that contains no Hi3D Materials or Model Derivative does not by itself trigger the branding, Agreement/NOTICE distribution, or scale-license obligations. Applicable law and third-party rights still apply.
 
-## Acknowledgments
+Existing **Apache-2.0 and MIT terms remain applicable to the original and third-party portions they cover**; those rights are not replaced by the Hi3D Agreement. The original Apache text is preserved in [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md#original-apache-license). See [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md), [NOTICE](NOTICE), and [AUTHORS](AUTHORS) for retained terms and attribution. The included Hunyuan adapter is distinct from the external Hunyuan implementation, weights, and outputs, which remain subject to their own terms, as do DINOv2 and CLIP.
 
-Hi3D v1.0 builds upon [Sparc3D: Sparse Representation and Construction for High-Resolution 3D Shapes Modeling](https://arxiv.org/abs/2505.14521). We acknowledge the original Sparc3D work and the research it builds upon.
+For Hi3D license inquiries, contact [contact@hi3d.ai](mailto:contact@hi3d.ai).
 
+Hi3D v1.0 builds upon [Sparc3D: Sparse Representation and Construction for High-Resolution 3D Shapes Modeling](https://arxiv.org/abs/2505.14521). We acknowledge the original Sparc3D work and its upstream research.

README.zh-CN.md

@@ -1,34 +1,34 @@
 # Hi3D v1.0
 
-<a href="https://huggingface.co/hi3d-official/Hi3Dv1.0"><kbd>English</kbd></a> · **简体中文**
+<a href="https://huggingface.co/hi3d-official/Hi3Dv1.0/blob/main/README.md"><kbd>English</kbd></a> · **简体中文**
 
 **基于 Sparc3D 的高分辨率 3D 几何细化模型。**
 
-**[在线体验](https://huggingface.co/spaces/ilcve21/Sparc3D)** · [GitHub 仓库](https://github.com/hi3d-official/Hi3Dv1.0) · [国际官网](http://hi3d.ai/) · [国内官网](https://www.hi3d.cn/)
+**[在线体验](https://huggingface.co/spaces/ilcve21/Sparc3D)** · [GitHub 代码仓库](https://github.com/hi3d-official/Hi3Dv1.0) · [国际官网](http://hi3d.ai/) · [国内官网](https://www.hi3d.cn/)
 
-计划于 2026 年 10 月 23 日开源。
-
-本 Hugging Face 仓库同步展示 [GitHub 官方项目](https://github.com/hi3d-official/Hi3Dv1.0)的预告内容，包含项目说明、系统框架与部分效果对比，尚未提供实际代码或模型权重。
+已于 2026 年 10 月 23 日公开发布。
 
 ## 项目介绍
 
-Hi3D v1.0 是 Hi3D 官方推出的高分辨率 3D 几何细化项目。模型基于 Sparc3D 几何流程，以参考图和粗网格共同作为输入，通过逐级稀疏重建细化物体几何。
+Hi3D v1.0 以同一物体的参考图和粗网格为输入，细化生成高分辨率几何。模型基于 Sparc3D 的表示与细化架构，逐级采样稀疏潜变量，通过自剪枝稀疏 VAE 解码并提取网格。
+
+项目报告采用约 **200 万个精选 3D 资产**的训练规模，并支持最高 **1536³** 有效稀疏提取网格分辨率。为保持兼容，Python 包与公开 API 继续使用 `sparc3d` 和 `Sparc3DPipeline` 名称。
 
-项目报告采用约 **200 万个精选 3D 资产**的训练规模，并支持最高 **1536³** 有效稀疏提取网格分辨率。Hi3D v1.0 沿用 Sparc3D 的表示与细化架构，重点在于训练数据规模与高分辨率几何。
+本仓库提供 **Hi3D v1.0 细化模型文件**；推理代码位于 [GitHub 仓库](https://github.com/hi3d-official/Hi3Dv1.0)，不包含训练代码和论文评测工具。模型文件已发布至 [Hugging Face](https://huggingface.co/hi3d-official/Hi3Dv1.0)。示例直接加载 `hi3d-official/Hi3Dv1.0`，也支持传入兼容的本地模型目录。
 
 ## 系统框架
 
 [![Hi3D v1.0 系统框架：参考图与粗网格输入、稀疏细化与三个网格提取层级](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/framework.png)](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/framework.png)
 
-图像特征在粗几何所确定的稀疏坐标上为流模型提供条件；自剪枝稀疏 VAE 解码器在预测表面附近扩展特征并提取网格。相邻层级之间，将已提取的网格重新体素化，形成下一层的稀疏支撑。
+图像特征在粗几何所确定的稀疏坐标上为流模型提供条件。解码与网格提取后，重新体素化网格，形成下一轮的稀疏支撑。
 
-| 层级 | 标称结构网格 | 稀疏提取网格 |
-| --- | --- | --- |
-| 1 | 64³ | 512³ |
-| 2 | 128³ | 1024³ |
-| 3 | 192³ | 1536³ |
+| 轮次 | 标称结构网格 | 稀疏提取网格 | Transformer |
+| --- | --- | --- | --- |
+| 1 | 64³ | 512³ | `transformer_512` |
+| 2 | 128³ | 1024³ | `transformer_1024` |
+| 3 | 192³ | 1536³ | `transformer_1024` |
 
-以上数值表示标称稀疏坐标与表面提取分辨率，并非稠密 1536³ 潜变量张量，也不表示固定的输出三角面数。
+请求 512³ 时运行一轮，1024³ 运行两轮，1536³ 运行三轮。以上数值表示标称稀疏坐标与提取网格，并非稠密 1536³ 潜变量张量，也不表示固定的三角面数。详见[流程说明](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/pipeline.md)。
 
 ## 效果对比
 
@@ -42,24 +42,170 @@ Hi3D v1.0 是 Hi3D 官方推出的高分辨率 3D 几何细化项目。模型基
 
 [![车辆、装甲角色、扶手椅与手提包的多视角几何对比](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-1.jpg)](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-1.jpg)
 
-四组物体分别展示正面、背面与底部视角。结果组合呈现灰模与彩色表面法线渲染，彩色部分不表示生成的纹理。Hi3D v1.0 以青绿色标出。
+四组物体分别展示正面、背面与底部视角。结果组合呈现灰模与彩色表面法线渲染，彩色部分不表示生成的纹理。隐藏视角展示合理补全，不能视为真实不可见表面的精确重建。
 
 <details>
 <summary>更多多视角示例</summary>
 
 [![人形半身像、机械机器人与风格化角色的更多多视角示例](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-2.jpg)](https://huggingface.co/hi3d-official/Hi3Dv1.0/resolve/main/assets/global-comparison-2.jpg)
 
-更多示例沿用上一张图的列顺序与渲染方式。
+更多示例沿用上一张图的列顺序与渲染方式，Hi3D v1.0 仍为青绿色���出的最右列。
 
 </details>
 
-## 适用范围与局限
+## 安装
+
+环境要求：**Linux、Python 3.10、计算能力不低于 8.0 的 NVIDIA GPU，以及与所装 PyTorch 构建匹配的 CUDA 12.0–12.5 工具链**。不支持 CPU 推理。已实测组合为 Python 3.10.12、PyTorch 2.5.0+cu124、CUDA toolkit 12.4.131 和 **96 GB NVIDIA H20**。1536³ 完整流程仅在该 GPU 上验证，尚无更小显存卡的峰值内存或可用性结论。
+
+克隆本仓库后，在仓库根目录、Python 3.10 环境中执行：
+
+```bash
+git clone https://github.com/hi3d-official/Hi3Dv1.0.git
+cd Hi3Dv1.0
+
+pip install torch==2.5.0+cu124 torchvision==0.20.0+cu124 \
+  --extra-index-url https://download.pytorch.org/whl/cu124
+pip install packaging ninja psutil
+pip install --no-build-isolation flash-attn==2.7.4.post1
+pip install -c docker/constraints.txt -e ".[inference]"
+```
+
+约束文件保留已实测的内核组合，包括 `spconv-cu120==2.3.6` 与 `flash-attn==2.7.4.post1`。先安装 PyTorch，再单独安装 `flash-attn`：其源码构建需要已安装的 torch 和 CUDA toolkit，并需关闭构建隔离。Triton 网格内核在首次调用时编译。本项目从源码安装，未提供 PyPI 发行包或预编译项目 wheel。
+
+需要演示脚本去背景功能时，另执行 `pip install -c docker/constraints.txt -e ".[demo]"`。该依赖组安装 `rembg`，不安装粗网格生成器。[安装文档](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/installation.md)提供 Docker、完整验证环境、离线配置与替代 CUDA/内核构建说明；其他配置尚未实测。
+
+## 模型文件
+
+[Hugging Face 模型仓库](https://huggingface.co/hi3d-official/Hi3Dv1.0/tree/main)根目录提供以下 8 个运行文件；下载到本地时请保持相同结构：
+
+```text
+model_index.json
+scheduler/scheduler_config.json
+vae/config.json
+vae/model.safetensors
+transformer_512/config.json
+transformer_512/model.safetensors
+transformer_1024/config.json
+transformer_1024/model.safetensors
+```
+
+加载器读取 JSON 和 safetensors，不执行模型仓库中的 Python，也不反序列化 pickle checkpoint。也可传入具有相同文件结构的 Hugging Face 模型仓库 ID。普通 Hub 加载会延迟加载高分辨率 Transformer；本地目录必须具备全部文件，启用顺序 CPU 卸载时会在 CPU 上实例化两个 Transformer。
+
+条件编码器 `facebook/dinov2-large` 和 `openai/clip-vit-large-patch14` 在首次使用时分别从 Hugging Face 加载，不包含在上述模型目录中。`--revision` 指定细化模型文件的版本；`--cache-dir` 指向存放 `models--*` 目录的位置，通常为 `$HF_HOME/hub`。
+
+## Python API
+
+```python
+from PIL import Image
+import trimesh
+from sparc3d import Sparc3DPipeline
+
+pipeline = Sparc3DPipeline.from_pretrained(
+    "hi3d-official/Hi3Dv1.0",
+).to("cuda")
+
+result = pipeline(
+    Image.open("input.png"),
+    trimesh.load("coarse.glb", force="mesh", process=False),
+    resolution=1024,
+    num_inference_steps=25,
+    seed=0,
+)
+result.mesh.export("refined.glb")
+```
+
+`result` 为 `Sparc3DPipelineOutput`，包含纯几何 `trimesh.Trimesh` 与实际生成的 `resolution`。支持 **512、1024、1536** 三档分辨率，默认每轮进行 25 次调度更新。`seed` 与本地 CPU `torch.Generator` 二选一。若已有形状为 `[N, 3]` 的唯一整数体素坐标，可使用 `pipeline.refine_voxels(image, voxel_coords, structure_resolution=64, resolution=1536, seed=0)`。
+
+### 内存卸载与进度
+
+要减少模型在 GPU 上的常驻内存，请在模型仍位于 CPU 时启用 Accelerate 卸载：
+
+```python
+pipeline = Sparc3DPipeline.from_pretrained("hi3d-official/Hi3Dv1.0")
+pipeline.enable_sequential_cpu_offload("cuda")
+```
+
+该模式替代 `.to("cuda")`，两者不可混用。卸载功能不构成最低显存承诺，也不能消除解码特征的内存开销。
+
+向 `from_pretrained` 传入 `progress_callback`，可在每次调度更新后收到 `Sparc3DProgressEvent`：
+
+```python
+def report(event):
+    print(f"pass {event.pass_index + 1}/{event.num_passes} "
+          f"step {event.step}/{event.num_inference_steps}")
+
+pipeline = Sparc3DPipeline.from_pretrained(
+    "hi3d-official/Hi3Dv1.0", progress_callback=report,
+).to("cuda")
+```
+
+解码、网格提取与后处理阶段不发送调度进度事件。
+
+## 命令行
+
+直接细化已有粗网格，无需 Hunyuan：
+
+```bash
+python demo/refine_mesh.py \
+  --model hi3d-official/Hi3Dv1.0 \
+  --image input.png --coarse-mesh coarse.glb --output refined.glb \
+  --resolution 1024 --num-inference-steps 25 --seed 0
+```
+
+可添加 `--sequential-cpu-offload` 启用模型卸载；安装演示依赖后，可添加 `--remove-background` 去除背景。去背景功能需主动启用，透明抠图的 alpha 通道会保留用于主体取景。
+
+离线细化时，为三个模型组件提供本地副本：
+
+```bash
+python demo/refine_mesh.py \
+  --model /path/to/hi3d-v1.0-model \
+  --image input.png --coarse-mesh coarse.glb --output refined.glb \
+  --local-files-only \
+  --dino-model /path/to/dinov2-large \
+  --clip-model /path/to/clip-vit-large-patch14
+```
+
+## 可选 Hunyuan 粗网格生成示例
+
+`demo/coarse_stage.py` 是 **Hunyuan3D-2 mini** 的可选适配器，使用 `tencent/Hunyuan3D-2mini` 及其 `hunyuan3d-dit-v2-mini-turbo` 子目录。`demo/image_to_mesh.py` 先调用该适配器，再运行细化。Hunyuan 仅用于演示一种上游粗网格生成方式，不是核心库的强制依赖，也不构成产品绑定。可替换适配器，或通过 `demo/refine_mesh.py` 直接提供自己的粗网格；后者没有 Hunyuan 导入。
+
+运行前，需单独安装 [Hunyuan3D-2 代码](https://github.com/Tencent-Hunyuan/Hunyuan3D-2)，并取得其权重：
+
+```bash
+python demo/image_to_mesh.py \
+  --model hi3d-official/Hi3Dv1.0 \
+  --image assets/example.png --output refined.glb \
+  --resolution 1024 --seed 0
+```
+
+Hunyuan 代码与权重属于第三方发行内容，并非由 Hi3D 开源或重新许可。请遵循[上游源码许可](https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/LICENSE)与 [Hunyuan3D-2 mini 模型许可](https://huggingface.co/tencent/Hunyuan3D-2mini/blob/main/LICENSE)，并参阅[外部模型与可选示例](THIRD_PARTY_LICENSES.md#external-models-and-optional-examples)和[粗网格阶段安装说明](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/installation.md#the-coarse-stage)。
+
+`--coarse-model` 与 `--coarse-subfolder` 可覆盖默认粗模型。离线运行全流程还需要本地 Hunyuan 模型；细化阶段的 `--local-files-only`、`--revision` 与 `--cache-dir` 不会配置 Hunyuan 加载器。
+
+## 适用范围与可复现性
+
+- **仅几何、单样本。** 不生成纹理、材质或顶点颜色。输出会重新居中并将最大半径归一为 1，不保留输入的世界坐标和绝对尺度。
+- **依赖粗结构。** 粗网格中的严重结构错误可能保留；图像不可见区域属于合理补全。
+- **需要 GPU 内核。** `flash-attn` 没有替代注意力路径。复杂输入的自适应体素化可能采用更粗的支撑网格，并发出警告；无法达到请求分辨率时会报错，不会静默返回较低分辨率。
+- **相同种子不保证相同网格哈希。** 细化采样器使用本地 CPU 随机数生成器，但 GPU 稀疏卷积与注意力并非逐位确定。请在相同输入、模型版本、调度器与环境下比较几何。
+- **仅支持推理验证。** 未包含训练代码、评测工具、基准划分与对比网格，不能仅凭本仓库复现论文对比表格。几何细节与标称分辨率也不保证满足特定下游应用。
+
+## 文档
+
+- [安装](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/installation.md)：已验证环境、Docker、离线加载与 GPU 依赖。
+- [流程](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/pipeline.md)：逐级细化、条件编码、网格提取与内存行为。
+- [复现](https://github.com/hi3d-official/Hi3Dv1.0/blob/main/docs/reproduction.md)：验证范围与有意义的运行间比较。
+
+## 许可证与致谢
+
+Schedule 2 列明的第二阶段实现与修改、文档、配置及八个模型文件中，Hi3D 自有或有权许可的部分适用 **[Hi3D Open License Agreement Version 1.0](LICENSE)**。范围与排除项见 [许可范围](THIRD_PARTY_LICENSES.md#license-scope)，具体以协议正文为准。
+
+- **协议允许商用。** 相关产品或服务的**月活用户超过 200,000**，或**月收入达到 1,000,000 美元**时，须在 **60 日内**通知许可方并申请单独书面许可，同时遵守第 5 条的合并计算与过渡规则。
+- **商业集成须展示 `Powered by Hi3D 1.0`**，按第 7 条要求在支持链接的位置链接至 Schedule 2 指定的官网。分发和使用还须遵守协议中的声明要求与可接受使用政策。
+- **纯输出适用不同规则。** 获取、编辑、展示、销售或分发不含 Hi3D Materials 或 Model Derivative 的输出，本身不触发上述品牌展示、随附协议／NOTICE 或规模许可义务；适用法律和第三方权利仍须遵守。
 
-- **几何输出。** Hi3D v1.0 聚焦几何，不生成纹理、材质或顶点颜色。
-- **依赖粗网格。** 上游粗网格提供整体结构，其中严重的结构错误可能在细化后保留。
-- **遮挡区域。** 输入图不可见的几何属于合理补全，不能视为真实隐藏表面的精确重建。
-- **按应用验证。** 视觉细节与标称分辨率本身不能保证网格满足特定下游工作流的要求。
+原有及第三方部分适用的 **Apache-2.0、MIT 条款继续有效**，其权利不被 Hi3D 协议替换。原 Apache 正文保留于 [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md#original-apache-license)，完整第三方条款与归属见 [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md)、[NOTICE](NOTICE) 和 [AUTHORS](AUTHORS)。本仓库的 Hunyuan 适配示例与外部 Hunyuan 实现、权重及输出相区分，后者仍适用各自条款；DINOv2 与 CLIP 同样适用其自身条款。
 
-## 致谢
+Hi3D 许可相关咨询请联系 [contact@hi3d.ai](mailto:contact@hi3d.ai)。
 
-Hi3D v1.0 基于 [Sparc3D](https://arxiv.org/abs/2505.14521) 构建，感谢原始 Sparc3D 工作及其所依托的研究。
+Hi3D v1.0 基于 [Sparc3D: Sparse Representation and Construction for High-Resolution 3D Shapes Modeling](https://arxiv.org/abs/2505.14521) 构建，感谢原始 Sparc3D 工作及相关上游研究。

THIRD_PARTY_LICENSES.md

@@ -0,0 +1,474 @@
+# Third-party licenses
+
+This license index adapts the SPARC3D third-party notices for Hi3D v1.0. The
+original license texts and attributions are retained, with additional references
+for separately obtained models and optional examples.
+
+The original SPARC3D license is retained in [Original Apache license](#original-apache-license).
+Hi3D-owned or otherwise licensable materials identified in Schedule 2 are governed
+by the Hi3D Agreement in [LICENSE](LICENSE). See [License scope](#license-scope)
+for the component boundaries; the new Agreement does not replace original
+third-party licenses or previously granted rights.
+
+Parts of this package are derived from other open-source projects. Each is listed
+below with the files it covers and the full text of its license, as those licenses
+require. Every file named here also carries a provenance header pointing back to
+this document.
+
+| Upstream | License | Covers |
+| --- | --- | --- |
+| [Microsoft TRELLIS](https://github.com/microsoft/TRELLIS) | MIT | the sparse transformer and its building blocks |
+| [Pointcept / Point Transformer V3](https://github.com/Pointcept/Pointcept) | MIT | the `Point` structure and the sparse PTv3 decoder |
+| [O-CNN (ocnn-pytorch)](https://github.com/octree-nn/ocnn-pytorch) | MIT | Z-order (Morton) encoding |
+| [NVIDIA FlexiCubes](https://github.com/nv-tlabs/FlexiCubes) | Apache-2.0 | dual-marching-cubes surface extraction |
+
+---
+
+## License scope
+
+This index explains the component boundaries in Schedule 2 of the
+[Hi3D Open License Agreement Version 1.0](LICENSE). It does not amend the
+Agreement or grant additional rights. The Agreement and each applicable
+third-party license govern their respective materials.
+
+| Component | Applicable terms |
+| --- | --- |
+| Second-stage implementation and modifications in `sparc3d/`, including package initialization | The Hi3D Agreement applies only to content OCEANO HK HOLDING LIMITED owns or is authorized to license; original third-party rights in the same files remain under their original terms |
+| `demo/refine_mesh.py`, `demo/image_to_mesh.py`, `demo/coarse_stage.py` | The Hi3D Agreement applies to licensable example code; Hunyuan's separate implementation, weights and outputs are excluded |
+| The README, documentation and configuration paths listed in Schedule 2 | The Hi3D Agreement applies to licensable content; original notices and third-party terms remain in effect |
+| The eight refinement artifacts listed in Schedule 2 | Distributed separately from the source code and Python packages under the Hi3D Agreement; other files or versions are not included merely by sharing a repository |
+| Original SPARC3D, TRELLIS, Pointcept, O-CNN and FlexiCubes rights | Retained Apache-2.0 or MIT terms, as detailed in this file and the original source headers |
+| Hunyuan3D-2mini, DINOv2, CLIP and other external dependencies | Their own upstream licenses; not relicensed by Hi3D |
+| The five files listed as Sample Media in Schedule 2 | Excluded from the Hi3D Agreement; their presence or display does not grant reuse rights |
+| Unreleased first-stage materials, training code, datasets, and brand assets | Excluded, subject to the limited trademark permissions expressly granted in the Agreement |
+
+`LicenseRef-Hi3D-1.0` denotes the custom Agreement in [LICENSE](LICENSE), not a
+blanket license for every file. Previously granted rights under applicable
+Apache-2.0 or MIT licenses are not withdrawn or replaced by the Hi3D Agreement.
+
+The source archive contains media expressly excluded by Schedule 2. Therefore
+its package metadata does not assert a single SPDX license expression for the
+whole archive. The complete applicable agreements and notices are included with
+the Python distributions.
+
+---
+
+## Microsoft TRELLIS
+
+Covers:
+
+- `sparc3d/models/transformers/sparc3d_transformer.py`
+- `sparc3d/nn/norm.py`
+- `sparc3d/nn/rope.py`
+- `sparc3d/nn/utils.py`
+- `sparc3d/nn/sparse/basic.py`
+- `sparc3d/nn/sparse/conv.py`
+- `sparc3d/nn/sparse/linear.py`
+- `sparc3d/nn/sparse/nonlinearity.py`
+- `sparc3d/nn/sparse/spatial.py`
+- `sparc3d/nn/sparse/attention/full_attn.py`
+- `sparc3d/nn/sparse/attention/modules.py`
+- `sparc3d/nn/sparse/transformer/blocks.py`
+- `sparc3d/nn/sparse/transformer/modulated.py`
+
+Each of these files states the specific SPARC3D modification in its header. In
+general the training paths, the alternative attention backends, and the dense
+variants were removed, leaving the released inference architecture.
+
+```
+MIT License
+
+Copyright (c) Microsoft Corporation.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE
+```
+
+---
+
+## Pointcept / Point Transformer V3
+
+Point Transformer V3 (Xiaoyang Wu et al.) is released as part of Pointcept.
+
+Covers:
+
+- `sparc3d/models/autoencoders/blocks.py`
+- `sparc3d/models/autoencoders/ptv3.py`
+- `sparc3d/structures/point.py`
+- `sparc3d/structures/point_modules.py`
+- `sparc3d/utils/misc.py`
+- `sparc3d/utils/precision.py`
+- `sparc3d/utils/serialization/default.py`
+
+The decoder half was specialized for the sparse mesh autoencoder; the encoder,
+the training paths, and the Hilbert serialization order were removed.
+
+```
+MIT License
+
+Copyright (c) 2023 Pointcept
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+---
+
+## O-CNN (ocnn-pytorch)
+
+Covers:
+
+- `sparc3d/utils/serialization/z_order.py`
+
+The Morton decode tables and the batch-index field of the key were removed; only
+`xyz2key` encoding is retained.
+
+```
+MIT License
+
+Copyright (c) 2022 Peng-Shuai Wang <wangps@hotmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+```
+
+---
+
+## NVIDIA FlexiCubes
+
+Covers:
+
+- `sparc3d/ops/flexicubes/`
+
+FlexiCubes retains its Apache-2.0 license. Its copy of the
+license ships in the package at `sparc3d/ops/flexicubes/LICENSE.txt`, satisfying
+Apache-2.0 section 4(a); the NVIDIA copyright notices are retained in the source
+files, satisfying 4(c); and `sparc3d/ops/flexicubes/flexicubes.py` carries a
+header enumerating every SPARC3D modification, satisfying 4(b). Upstream ships no
+`NOTICE` file, so 4(d) does not apply.
+
+The vendored copy is inference-only: the tetrahedral output, the learned
+interpolation weights, the developability regularizer, and the gradient hooks
+were removed.
+
+
+---
+
+## External models and optional examples
+
+This section indexes components obtained separately at runtime or by the user.
+It does not add their code or weights to this distribution, grant a license to
+them, or replace their upstream terms. Neither the Hi3D Agreement nor a retained
+source-code license automatically applies to external model weights or
+third-party outputs.
+
+### Required external image encoders
+
+The default image conditioner loads the following models separately. Neither is
+included in the Hi3D refinement checkpoint or in this source tree.
+
+| Component | Role | Official model source | Upstream license reference |
+| --- | --- | --- | --- |
+| DINOv2-large | Spatial image features | [facebook/dinov2-large](https://huggingface.co/facebook/dinov2-large) | [Apache-2.0, DINOv2 LICENSE](https://github.com/facebookresearch/dinov2/blob/main/LICENSE) |
+| CLIP ViT-L/14 | Global image conditioning | [openai/clip-vit-large-patch14](https://huggingface.co/openai/clip-vit-large-patch14) | [MIT, CLIP LICENSE](https://github.com/openai/CLIP/blob/main/LICENSE) |
+
+Consult each model's own model card and the terms supplied with the version you
+obtain. Background-removal models used by the optional `rembg` integration are
+also obtained separately and retain their own terms.
+
+### Optional Hunyuan3D coarse-mesh example
+
+`demo/coarse_stage.py` is a Hi3D / SPARC3D example adapter. It imports
+`hy3dgen.shapegen.Hunyuan3DDiTFlowMatchingPipeline` only when that example is used.
+Its default model is `tencent/Hunyuan3D-2mini`, subfolder
+`hunyuan3d-dit-v2-mini-turbo`.
+
+**Hunyuan3D is only an optional example of coarse-mesh generation.** It is not a
+mandatory dependency of the Hi3D refinement library or a required product
+integration. `demo/refine_mesh.py` and the core `sparc3d` package accept a supplied
+coarse mesh without using Hunyuan3D. Other suitable coarse-mesh generators can be
+used instead. Installing the `[inference]` or `[demo]` extras does not install
+Hunyuan3D.
+
+**Tencent's Hunyuan3D implementation and pretrained weights are third-party
+releases, not open-source content released by Hi3D.** They are not bundled with
+this repository and are not relicensed under the Hi3D Agreement or any
+retained source-code license. Users who
+choose this example obtain them separately and comply with their upstream terms.
+
+| Component used by the example | Official source | Applicable upstream agreement |
+| --- | --- | --- |
+| Hunyuan3D-2 implementation (`hy3dgen`) | [Tencent-Hunyuan/Hunyuan3D-2](https://github.com/Tencent-Hunyuan/Hunyuan3D-2) | [Tencent Hunyuan 3D 2.0 Community License Agreement — source LICENSE](https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/LICENSE) |
+| Hunyuan3D-2mini weights, mini-turbo variant | [tencent/Hunyuan3D-2mini](https://huggingface.co/tencent/Hunyuan3D-2mini) | [Tencent Hunyuan 3D 2.0 Community License Agreement — model LICENSE](https://huggingface.co/tencent/Hunyuan3D-2mini/blob/main/LICENSE) |
+
+Upstream license terms are version-specific. If you select a different model,
+subfolder, or source version, consult its matching license and model card.
+Example-only use does not waive applicable restrictions, attribution,
+redistribution, or hosted-service obligations in those agreements.
+
+### Hi3D refinement weights
+
+The eight Hi3D refinement artifacts identified and released under Schedule 2
+are governed by the Hi3D Agreement in [LICENSE](LICENSE). They are distributed
+separately from this source repository; see [License scope](#license-scope).
+Other model files are not covered merely because they share the repository or
+use a similar name.
+
+
+---
+
+## Original Apache license
+
+The following is the original SPARC3D Apache-2.0 text, retained without changes.
+It continues to govern the materials and rights to which it originally applied;
+the Hi3D Agreement does not revoke those grants.
+
+```text
+
+                                 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 2026 The SPARC3D Authors
+
+   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.
+```

model_index.json

@@ -0,0 +1,9 @@
+{
+  "_class_name": "Sparc3DPipeline",
+  "_format_version": "1.0",
+  "_sparc3d_version": "0.1.0",
+  "scheduler": "scheduler",
+  "vae": "vae",
+  "transformer_512": "transformer_512",
+  "transformer_1024": "transformer_1024"
+}

scheduler/scheduler_config.json

@@ -0,0 +1,6 @@
+{
+  "_class_name": "FlowMatchHeunScheduler",
+  "num_inference_steps": 25,
+  "sigma_min": 0.002,
+  "time_rescale_factor": 2.0
+}

sparc3d/ops/flexicubes/LICENSE.txt

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

transformer_1024/config.json

@@ -0,0 +1,84 @@
+{
+  "resolution": 128,
+  "in_channels": 32,
+  "out_channels": 32,
+  "model_channels": 2112,
+  "cond_channels": 2048,
+  "num_blocks": 24,
+  "num_heads": 22,
+  "mlp_ratio": 4.0,
+  "patch_size": 2,
+  "num_io_res_blocks": 2,
+  "io_block_channels": [
+    256
+  ],
+  "use_fp16": true,
+  "latent_mean": [
+    -0.00155994,
+    0.03314649,
+    -0.00307796,
+    0.00630751,
+    -0.00835457,
+    -0.03860179,
+    0.02528263,
+    0.0374062,
+    -0.06209833,
+    -0.00539356,
+    -0.02110271,
+    0.05126001,
+    0.00753371,
+    0.02866821,
+    0.02772475,
+    -0.02131735,
+    -0.02799912,
+    0.01084617,
+    0.03433723,
+    -0.009031,
+    -0.00121899,
+    -0.01944244,
+    0.01641873,
+    -0.01063657,
+    -0.01990618,
+    0.04856062,
+    0.01747232,
+    -0.02387775,
+    0.03216169,
+    -0.03732105,
+    -0.03730354,
+    -0.01948937
+  ],
+  "latent_std": [
+    0.61686146,
+    0.8011532,
+    0.854892,
+    0.96384716,
+    0.7700591,
+    0.6285985,
+    0.61541015,
+    0.7436831,
+    0.6276261,
+    1.0184228,
+    0.77113867,
+    0.6262799,
+    0.68749195,
+    0.62698966,
+    0.7549124,
+    0.615774,
+    0.6378066,
+    0.80406,
+    0.83846325,
+    0.6912039,
+    0.6922758,
+    0.79321617,
+    0.6347593,
+    0.638483,
+    0.67194235,
+    0.7351938,
+    0.84781533,
+    0.9301291,
+    0.6269144,
+    0.6790608,
+    0.6519877,
+    0.7769204
+  ]
+}

transformer_1024/model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a2ca5e44dde51cacecd59b42fceeb5f14e75d55e6dd047337752c4e6f281008c
+size 3675679280

transformer_512/config.json

@@ -0,0 +1,84 @@
+{
+  "resolution": 64,
+  "in_channels": 32,
+  "out_channels": 32,
+  "model_channels": 2112,
+  "cond_channels": 2048,
+  "num_blocks": 24,
+  "num_heads": 22,
+  "mlp_ratio": 4.0,
+  "patch_size": 2,
+  "num_io_res_blocks": 2,
+  "io_block_channels": [
+    256
+  ],
+  "use_fp16": true,
+  "latent_mean": [
+    -0.00155994,
+    0.03314649,
+    -0.00307796,
+    0.00630751,
+    -0.00835457,
+    -0.03860179,
+    0.02528263,
+    0.0374062,
+    -0.06209833,
+    -0.00539356,
+    -0.02110271,
+    0.05126001,
+    0.00753371,
+    0.02866821,
+    0.02772475,
+    -0.02131735,
+    -0.02799912,
+    0.01084617,
+    0.03433723,
+    -0.009031,
+    -0.00121899,
+    -0.01944244,
+    0.01641873,
+    -0.01063657,
+    -0.01990618,
+    0.04856062,
+    0.01747232,
+    -0.02387775,
+    0.03216169,
+    -0.03732105,
+    -0.03730354,
+    -0.01948937
+  ],
+  "latent_std": [
+    0.61686146,
+    0.8011532,
+    0.854892,
+    0.96384716,
+    0.7700591,
+    0.6285985,
+    0.61541015,
+    0.7436831,
+    0.6276261,
+    1.0184228,
+    0.77113867,
+    0.6262799,
+    0.68749195,
+    0.62698966,
+    0.7549124,
+    0.615774,
+    0.6378066,
+    0.80406,
+    0.83846325,
+    0.6912039,
+    0.6922758,
+    0.79321617,
+    0.6347593,
+    0.638483,
+    0.67194235,
+    0.7351938,
+    0.84781533,
+    0.9301291,
+    0.6269144,
+    0.6790608,
+    0.6519877,
+    0.7769204
+  ]
+}

transformer_512/model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8ba88311dccf23463c6e10dd0d3bd5e0c5c35d1608c6f466413b6428b5ad8e56
+size 3675679280

vae/config.json

@@ -0,0 +1,9 @@
+{
+  "model": {
+    "type": "SparconvVAE",
+    "decoder_cfg": {
+      "type": "PTv3MeshDecoder",
+      "z_channels": 32
+    }
+  }
+}

vae/model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:605d207c77f8db0b33c567a5861252f0090cf3c3604dfda1cfee09e8f0b53f3e
+size 376629712