Upload 6 files

LICENSE

@@ -0,0 +1,240 @@
+Creative Commons Attribution-NonCommercial 4.0 International Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree to be
+bound by the terms and conditions of this Creative Commons
+Attribution-NonCommercial 4.0 International Public License ("Public
+License"). To the extent this Public License may be interpreted as a contract,
+You are granted the Licensed Rights in consideration of Your acceptance of
+these terms and conditions, and the Licensor grants You such rights in
+consideration of benefits the Licensor receives from making the Licensed
+Material available under these terms and conditions.
+
+Section 1 - Definitions.
+
+1. Adapted Material means material subject to Copyright and Similar Rights
+   that is derived from or based upon the Licensed Material and in which the
+   Licensed Material is translated, altered, arranged, transformed, or
+   otherwise modified in a manner requiring permission under the Copyright and
+   Similar Rights held by the Licensor. For purposes of this Public License,
+   where the Licensed Material is a musical work, performance, or sound
+   recording, Adapted Material is always produced where the Licensed Material
+   is synched in timed relation with a moving image.
+2. Adapter's License means the license You apply to Your Copyright and Similar
+   Rights in Your contributions to Adapted Material in accordance with the
+   terms and conditions of this Public License.
+3. Copyright and Similar Rights means copyright and/or similar rights closely
+   related to copyright including, without limitation, performance, broadcast,
+   sound recording, and Sui Generis Database Rights, without regard to how the
+   rights are labeled or categorized. For purposes of this Public License, the
+   rights specified in Section 2(b)(1)-(2) are not Copyright and Similar
+   Rights.
+4. Effective Technological Measures means those measures that, in the absence
+   of proper authority, may not be circumvented under laws fulfilling
+   obligations under Article 11 of the WIPO Copyright Treaty adopted on
+   December 20, 1996, and/or similar international agreements.
+5. Exceptions and Limitations means fair use, fair dealing, and/or any other
+   exception or limitation to Copyright and Similar Rights that applies to Your
+   use of the Licensed Material.
+6. Licensed Material means the artistic or literary work, database, or other
+   material to which the Licensor applied this Public License.
+7. Licensed Rights means the rights granted to You subject to the terms and
+   conditions of this Public License, which are limited to all Copyright and
+   Similar Rights that apply to Your use of the Licensed Material and that the
+   Licensor has authority to license.
+8. Licensor means the individual(s) or entity(ies) granting rights under this
+   Public License.
+9. NonCommercial means not primarily intended for or directed towards
+   commercial advantage or monetary compensation. For purposes of this Public
+   License, the exchange of the Licensed Material for other material subject to
+   Copyright and Similar Rights by digital file-sharing or similar means is
+   NonCommercial provided there is no payment of monetary compensation in
+   connection with the exchange.
+10. Share means to provide material to the public by any means or process that
+    requires permission under the Licensed Rights, such as reproduction, public
+    display, public performance, distribution, dissemination, communication, or
+    importation, and to make material available to the public including in ways
+    that members of the public may access the material from a place and at a
+    time individually chosen by them.
+11. Sui Generis Database Rights means rights other than copyright resulting
+    from Directive 96/9/EC of the European Parliament and of the Council of 11
+    March 1996 on the legal protection of databases, as amended and/or
+    succeeded, as well as other essentially equivalent rights anywhere in the
+    world.
+12. You means the individual or entity exercising the Licensed Rights under
+    this Public License. Your has a corresponding meaning.
+
+Section 2 - Scope.
+
+1. License grant.
+   a. Subject to the terms and conditions of this Public License, the Licensor
+      hereby grants You a worldwide, royalty-free, non-sublicensable,
+      non-exclusive, irrevocable license to exercise the Licensed Rights in the
+      Licensed Material to:
+      1. reproduce and Share the Licensed Material, in whole or in part, for
+         NonCommercial purposes only; and
+      2. produce, reproduce, and Share Adapted Material for NonCommercial
+         purposes only.
+   b. Exceptions and Limitations. For the avoidance of doubt, where Exceptions
+      and Limitations apply to Your use, this Public License does not apply,
+      and You do not need to comply with its terms and conditions.
+   c. Term. The term of this Public License is specified in Section 6(a).
+   d. Media and formats; technical modifications allowed. The Licensor
+      authorizes You to exercise the Licensed Rights in all media and formats
+      whether now known or hereafter created, and to make technical
+      modifications necessary to do so. The Licensor waives and/or agrees not
+      to assert any right or authority to forbid You from making technical
+      modifications necessary to exercise the Licensed Rights, including
+      technical modifications necessary to circumvent Effective Technological
+      Measures. For purposes of this Public License, simply making
+      modifications authorized by this Section 2(a)(4) never produces Adapted
+      Material.
+   e. Downstream recipients.
+      1. Offer from the Licensor - Licensed Material. Every recipient of the
+         Licensed Material automatically receives an offer from the Licensor to
+         exercise the Licensed Rights under the terms and conditions of this
+         Public License.
+      2. No downstream restrictions. You may not offer or impose any
+         additional or different terms or conditions on, or apply any
+         Effective Technological Measures to, the Licensed Material if doing so
+         restricts exercise of the Licensed Rights by any recipient of the
+         Licensed Material.
+   f. No endorsement. Nothing in this Public License constitutes or may be
+      construed as permission to assert or imply that You are, or that Your use
+      of the Licensed Material is, connected with, or sponsored, endorsed, or
+      granted official status by, the Licensor or others designated to receive
+      attribution as provided in Section 3(a)(1)(A)(i).
+2. Other rights.
+   a. Moral rights, such as the right of integrity, are not licensed under
+      this Public License, nor are publicity, privacy, and/or other similar
+      personality rights; however, to the extent possible, the Licensor waives
+      and/or agrees not to assert any such rights held by the Licensor to the
+      limited extent necessary to allow You to exercise the Licensed Rights,
+      but not otherwise.
+   b. Patent and trademark rights are not licensed under this Public License.
+   c. To the extent possible, the Licensor waives any right to collect
+      royalties from You for the exercise of the Licensed Rights, whether
+      directly or through a collecting society under any voluntary or waivable
+      statutory or compulsory licensing scheme. In all other cases the Licensor
+      expressly reserves any right to collect such royalties, including when
+      the Licensed Material is used other than for NonCommercial purposes.
+
+Section 3 - License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the following
+conditions.
+
+1. Attribution.
+   a. If You Share the Licensed Material (including in modified form), You
+      must:
+      1. retain the following if it is supplied by the Licensor with the
+         Licensed Material:
+         a. identification of the creator(s) of the Licensed Material and any
+            others designated to receive attribution, in any reasonable manner
+            requested by the Licensor (including by pseudonym if designated);
+         b. a copyright notice;
+         c. a notice that refers to this Public License;
+         d. a notice that refers to the disclaimer of warranties;
+         e. a URI or hyperlink to the Licensed Material to the extent
+            reasonably practicable;
+      2. indicate if You modified the Licensed Material and retain an
+         indication of any previous modifications; and
+      3. indicate the Licensed Material is licensed under this Public License,
+         and include the text of, or the URI or hyperlink to, this Public
+         License.
+   b. You may satisfy the conditions in Section 3(a)(1) in any reasonable
+      manner based on the medium, means, and context in which You Share the
+      Licensed Material. For example, it may be reasonable to satisfy the
+      conditions by providing a URI or hyperlink to a resource that includes
+      the required information.
+   c. If requested by the Licensor, You must remove any of the information
+      required by Section 3(a)(1)(A) to the extent reasonably practicable.
+   d. If You Share Adapted Material You produce, the Adapter's License You
+      apply must not prevent recipients of the Adapted Material from complying
+      with this Public License.
+
+Section 4 - Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that apply to
+Your use of the Licensed Material:
+
+1. for the avoidance of doubt, Section 2(a)(1) grants You the right to
+   extract, reuse, reproduce, and Share all or a substantial portion of the
+   contents of the database for NonCommercial purposes only;
+2. if You include all or a substantial portion of the database contents in a
+   database in which You have Sui Generis Database Rights, then the database in
+   which You have Sui Generis Database Rights (but not its individual contents)
+   is Adapted Material; and
+3. You must comply with the conditions in Section 3(a) if You Share all or a
+   substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not replace
+Your obligations under this Public License where the Licensed Rights include
+other Copyright and Similar Rights.
+
+Section 5 - Disclaimer of Warranties and Limitation of Liability.
+
+1. Unless otherwise separately undertaken by the Licensor, to the extent
+   possible, the Licensor offers the Licensed Material as-is and as-available,
+   and makes no representations or warranties of any kind concerning the
+   Licensed Material, whether express, implied, statutory, or other. This
+   includes, without limitation, warranties of title, merchantability, fitness
+   for a particular purpose, non-infringement, absence of latent or other
+   defects, accuracy, or the presence or absence of errors, whether or not
+   known or discoverable. Where disclaimers of warranties are not allowed in
+   full or in part, this disclaimer may not apply to You.
+2. To the extent possible, in no event will the Licensor be liable to You on
+   any legal theory (including, without limitation, negligence) or otherwise
+   for any direct, special, indirect, incidental, consequential, punitive,
+   exemplary, or other losses, costs, expenses, or damages arising out of this
+   Public License or use of the Licensed Material, even if the Licensor has
+   been advised of the possibility of such losses, costs, expenses, or damages.
+   Where a limitation of liability is not allowed in full or in part, this
+   limitation may not apply to You.
+3. The disclaimer of warranties and limitation of liability provided above
+   shall be interpreted in a manner that, to the extent possible, most closely
+   approximates an absolute disclaimer and waiver of all liability.
+
+Section 6 - Term and Termination.
+
+1. This Public License applies for the term of the Copyright and Similar
+   Rights licensed here. However, if You fail to comply with this Public
+   License, then Your rights under this Public License terminate automatically.
+2. Where Your right to use the Licensed Material has terminated under
+   Section 6(a), it reinstates:
+   a. automatically as of the date the violation is cured, provided it is
+      cured within 30 days of Your discovery of the violation; or
+   b. upon express reinstatement by the Licensor.
+   For the avoidance of doubt, this Section 6(b) does not affect any right the
+   Licensor may have to seek remedies for Your violations of this Public
+   License.
+3. For the avoidance of doubt, the Licensor may also offer the Licensed
+   Material under separate terms or conditions or stop distributing the
+   Licensed Material at any time; however, doing so will not terminate this
+   Public License.
+4. Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
+
+Section 7 - Other Terms and Conditions.
+
+1. The Licensor shall not be bound by any additional or different terms or
+   conditions communicated by You unless expressly agreed.
+2. Any arrangements, understandings, or agreements regarding the Licensed
+   Material not stated herein are separate from and independent of the terms
+   and conditions of this Public License.
+
+Section 8 - Interpretation.
+
+1. For the avoidance of doubt, this Public License does not, and shall not be
+   interpreted to, reduce, limit, restrict, or impose conditions on any use of
+   the Licensed Material that could lawfully be made without permission under
+   this Public License.
+2. To the extent possible, if any provision of this Public License is deemed
+   unenforceable, it shall be automatically reformed to the minimum extent
+   necessary to make it enforceable. If the provision cannot be reformed, it
+   shall be severed from this Public License without affecting the
+   enforceability of the remaining terms and conditions.
+3. No term or condition of this Public License will be waived and no failure to
+   comply consented to unless expressly agreed to by the Licensor.
+4. Nothing in this Public License constitutes or may be interpreted as a
+   limitation upon, or waiver of, any privileges and immunities that apply to
+   the Licensor or You, including from the legal processes of any jurisdiction
+   or authority.

README.md

@@ -0,0 +1,83 @@
+---
+license: cc-by-nc-4.0
+pipeline_tag: image-to-3d
+base_model: yyfz233/Pi3X
+tags:
+- lux3d
+- rust
+- candle
+- safetensors
+- canonical-weights
+- 3d
+- image-to-3d
+- point-cloud
+- multiview
+- pi3x
+---
+
+# Lux3D Pi3X Canonical Weights
+
+This repository contains the canonicalized `safetensors` export of the Pi3X checkpoint used by the Lux3D runtime.
+
+## Model Details
+
+- Model family: `pi3x`
+- Canonical file: `model.safetensors`
+- Tensor count: `1873`
+- Primary runtime target: Lux3D runtime
+- Typical output: point cloud export (`.ply`)
+
+## Included Files
+
+- `model.safetensors`
+- `resolved_config.json`
+- `manifest.json`
+- `checksums.json`
+
+## Usage With Lux3D
+
+The Lux3D CLI can validate and use the package once it is installed into your local model asset layout.
+
+```powershell
+cargo run -p lux3d-cli -- inspect --repo-root <runtime-root> pi3x
+cargo run -p lux3d-cli -- run --repo-root <runtime-root> pi3x --source <input-sequence> --conditions <conditions-file> --output <output-file.ply>
+cargo run -p lux3d-cli -- run --repo-root <runtime-root> pi3x --source <input-video> --vo --chunk-size 8 --overlap 4 --conf-threshold 0.05 --inject-condition pose,depth,ray --output <output-file.ply>
+```
+
+## Provenance
+
+- Upstream source model: [`yyfz233/Pi3X`](https://huggingface.co/yyfz233/Pi3X)
+- Canonicalization flow: `tools/python_baseline/normalize_weights.py`
+
+The exact source checksum set is recorded in `manifest.json`. The integrity of the uploaded package is recorded in `checksums.json`.
+
+## Intended Use
+
+- Pi3X reconstruction workflows with Lux3D
+- multiview point cloud generation
+- VO-assisted Pi3X inference
+- reproducible runtime validation
+
+## Limitations
+
+- Verified Lux3D runtime inference currently assumes CUDA.
+- This package contains canonical runtime artifacts only.
+- The upstream Pi3X weights are non-commercial.
+
+## License
+
+- Upstream model page: [`yyfz233/Pi3X`](https://huggingface.co/yyfz233/Pi3X)
+- License file in this repository: [LICENSE](LICENSE)
+
+Review upstream terms before redistribution or commercial use.
+
+## Citation
+
+```bibtex
+@article{wang2025pi,
+  title={$\pi^3$: Permutation-Equivariant Visual Geometry Learning},
+  author={Wang, Yifan and Zhou, Jianjun and Zhu, Haoyi and Chang, Wenzheng and Zhou, Yang and Li, Zizun and Chen, Junyi and Pang, Jiangmiao and Shen, Chunhua and He, Tong},
+  journal={arXiv preprint arXiv:2507.13347},
+  year={2025}
+}
+```

checksums.json

@@ -0,0 +1,19 @@
+{
+  "files": [
+    {
+      "relative_path": "3d/canonical-weights/pi3x/model.safetensors",
+      "sha256": "69972d6e1c4492cb4d737a84fe940e357087d81c52f5c9b7c160b49c1f41669a",
+      "size_bytes": 5440325620
+    },
+    {
+      "relative_path": "3d/canonical-weights/pi3x/resolved_config.json",
+      "sha256": "9373944bc35b5e06aed4f828062c1062aa248018d7685d84eed71457d9ae6532",
+      "size_bytes": 47
+    },
+    {
+      "relative_path": "3d/canonical-weights/pi3x/manifest.json",
+      "sha256": "6a2dbcedaa7827f9dc22b2030fff2baa7107a803b5a0bda02f0d77a2342b49f3",
+      "size_bytes": 646
+    }
+  ]
+}

manifest.json

@@ -0,0 +1,18 @@
+{
+  "canonical_file": "3d/canonical-weights/pi3x/model.safetensors",
+  "dtype_histogram": {
+    "float32": 1873
+  },
+  "family": "pi3x",
+  "normalizer_version": 1,
+  "raw_files": [
+    "3d/models/yyfz233-Pi3X/model.safetensors",
+    "3d/models/yyfz233-Pi3X/config.json"
+  ],
+  "resolved_config_file": "3d/canonical-weights/pi3x/resolved_config.json",
+  "source_checksums": {
+    "3d/models/yyfz233-Pi3X/config.json": "0e7d23382f8dc98b6eb15c546a5cb6bfe0021e290d43d72adb0842d57b031967",
+    "3d/models/yyfz233-Pi3X/model.safetensors": "69972d6e1c4492cb4d737a84fe940e357087d81c52f5c9b7c160b49c1f41669a"
+  },
+  "tensor_count": 1873
+}

model.safetensors

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

resolved_config.json

@@ -0,0 +1,4 @@
+{
+  "ckpt": null,
+  "use_multimodal": true
+}