Upload 8 files

.gitattributes

@@ -1,35 +1 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.gguf filter=lfs diff=lfs merge=lfs -text

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,104 @@
+---
+license: cc-by-nc-4.0
+base_model: oxide-lab/Pi3X
+tags:
+- gguf
+- lux3d
+- pi3x
+- point-cloud
+- image-to-3d
+library_name: lux3d
+---
+
+# Pi3X — GGUF quantizations (Lux3D)
+
+Standalone GGUF builds of the **Pi3X** point-cloud reconstruction model,
+quantized from the canonical [oxide-lab/Pi3X](https://huggingface.co/oxide-lab/Pi3X)
+F32 package by [Lux3D](https://github.com/oxide-lab/Lux3d).
+
+Each file is a complete package: `resolved_config.json` is embedded in the
+GGUF metadata, so `--model-path` accepts the file directly. No sibling
+`manifest.json`, `checksums.json` or safetensors file is required.
+
+## Files
+
+| file | dtype | size | status |
+|---|---|---|---|
+| `pi3x-q8_0.gguf` | Q8_0, F16 fallback | 1.365 GiB | recommended |
+| `pi3x-q6_k.gguf` | Q6_K, F16 fallback | 1.064 GiB | not recommended |
+| `pi3x-q5_k.gguf` | Q5_K, F16 fallback | 0.898 GiB | not recommended |
+| `pi3x-q4_k.gguf` | Q4_K, F16 fallback | 0.742 GiB | not recommended |
+
+Canonical F32 package size: 5.07 GiB. SHA-256 and exact byte sizes are in
+[`checksums.json`](checksums.json). Quantized matrices: 466 per variant.
+
+## Evaluation
+
+Reference: the same CUDA backend running the canonical F32 package. Input: the
+three 512x512 synthetic frames in the Lux3D test assets. Metrics are drift
+against F32, not ground-truth accuracy: Chamfer-L1 relative to the reference
+bbox diagonal and symmetric F-score at 0.5%/1% of that diagonal.
+
+| variant | CD rel | F@0.5% | F@1% | F@2% |
+|---|---|---|---|---|
+| q8_0 | 0.081% | 0.99999 | 1.000 | 1.000 |
+| q6_k | 0.873% | 0.129 | 0.598 | 1.000 |
+| q5_k | 2.279% | 0.000 | 0.000 | 0.195 |
+| q4_k | 0.789% | 0.274 | 0.719 | 0.986 |
+
+Q8_0 is stable across backends: F@1% is 1.000 on CUDA, Vulkan, WGPU and CPU.
+The lower-bit results are not monotonic because the model is highly sensitive
+to small weight perturbations. The image `encoder.` is the main hotspot: with
+that module kept in F16, Q6_K recovers F@1% from 0.598 to 0.99996, but the
+resulting package is 1.40 GiB versus 1.37 GiB for all-Q8_0, so Q8_0 is the
+better choice. Publish Q8_0 only for production use.
+
+## Usage
+
+```bash
+# download
+hf download oxide-lab/Pi3X-GGUF pi3x-q8_0.gguf --local-dir .
+
+# point cloud from a frame directory
+lux3d-cli run pi3x --device cuda \
+  --model-path pi3x-q8_0.gguf \
+  --source ./frames \
+  --output cloud.ply
+
+# optional conditions file (depth/pose/ray/intrinsic injection)
+lux3d-cli run pi3x --device cuda \
+  --model-path pi3x-q8_0.gguf \
+  --source ./frames \
+  --conditions ./condition.npz \
+  --output cloud.ply
+
+# VO mode
+lux3d-cli run pi3x --device cuda \
+  --model-path pi3x-q8_0.gguf \
+  --source ./video.mp4 --vo \
+  --chunk-size 8 --overlap 4 --conf-threshold 0.05 \
+  --output cloud.ply
+```
+
+The result is an ASCII PLY with positions and RGB colors. `.xyz` is also
+accepted as a plain-text alternative.
+
+## Conversion
+
+```bash
+lux3d-cli weights quantize pi3x \
+  --source /path/to/canonical-pi3x/model.safetensors \
+  --output pi3x-q8_0.gguf \
+  --dtype q8_0 --fallback-dtype f16
+```
+
+Only rank-2 `*.weight` matrices are quantized; norms, biases, embeddings,
+convolutions and rows that do not divide into the dtype block stay in F16.
+Quantized linears run through `QMatMul`.
+
+## License
+
+Pi3X weights are distributed under the **Creative Commons
+Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)** license; see
+[`LICENSE`](LICENSE). Commercial use requires a separate license from the
+rights holder. The Lux3D conversion does not change the upstream terms.

checksums.json

@@ -0,0 +1,24 @@
+{
+  "files": [
+    {
+      "relative_path": "pi3x-q8_0.gguf",
+      "sha256": "e5f405f3e2bdb5dd26bcfe6aa35ec9bc3efb7f2319a31d622aede9b154bba000",
+      "size_bytes": 1466068672
+    },
+    {
+      "relative_path": "pi3x-q6_k.gguf",
+      "sha256": "f0670ab973cf70a0b8f4b595da0f7c0f1c1a2524e6341076ad0d5a99d7e278e0",
+      "size_bytes": 1142087872
+    },
+    {
+      "relative_path": "pi3x-q5_k.gguf",
+      "sha256": "c33fd5fa2f463ad4d8da5ffa1ee7a83be1ed89b44bb7e4156631b0315a6c3c71",
+      "size_bytes": 964420864
+    },
+    {
+      "relative_path": "pi3x-q4_k.gguf",
+      "sha256": "81ab55f4c52425d8d331939b38b3caf9faff520fe81ac50474bdc6e78cfddf45",
+      "size_bytes": 797204928
+    }
+  ]
+}

pi3x-q4_k.gguf

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

pi3x-q5_k.gguf

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

pi3x-q6_k.gguf

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

pi3x-q8_0.gguf

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