Upload 6 files

LICENSE

@@ -0,0 +1,25 @@
+BSD 2-Clause License
+
+Copyright (c) 2025, the authors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,80 @@
+---
+license: bsd-2-clause
+pipeline_tag: image-to-3d
+base_model: yyfz233/Pi3
+tags:
+- lux3d
+- rust
+- candle
+- safetensors
+- canonical-weights
+- 3d
+- image-to-3d
+- point-cloud
+- pi3
+---
+
+# Lux3D Pi3 Canonical Weights
+
+This repository contains the canonicalized `safetensors` export of the Pi3 checkpoint used by the Lux3D runtime.
+
+## Model Details
+
+- Model family: `pi3`
+- Canonical file: `model.safetensors`
+- Tensor count: `1210`
+- Primary runtime target: Lux3D runtime
+- Typical output: affine-invariant 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> pi3
+cargo run -p lux3d-cli -- run --repo-root <runtime-root> pi3 --source <input-sequence> --output <output-file.ply>
+```
+
+## Provenance
+
+- Upstream source model: [`yyfz233/Pi3`](https://huggingface.co/yyfz233/Pi3)
+- Canonicalization flow: `tools/python_baseline/normalize_weights.py`
+
+The exact source checksum and canonical checksum set are recorded in `manifest.json` and `checksums.json`.
+
+## Intended Use
+
+- image or video to 3D reconstruction with Lux3D
+- point cloud export workflows based on the Pi3 contract
+- reproducible runtime validation
+
+## Limitations
+
+- Verified Lux3D runtime inference currently assumes CUDA.
+- This package is for the base `pi3` family, not `pi3x`.
+- The repository contains canonicalized runtime artifacts, not the full upstream training or demo stack.
+
+## License
+
+- Upstream model page: [`yyfz233/Pi3`](https://huggingface.co/yyfz233/Pi3)
+- License file in this repository: [LICENSE](LICENSE)
+
+Review upstream terms before redistribution or commercial use.
+
+## Citation
+
+```bibtex
+@article{wang2025pi,
+  title={$\pi^3$: Scalable 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/pi3/model.safetensors",
+      "sha256": "33580e4702ac671558aedeab1148fd08118f7ce45bdbeb99f3e3cf340062875d",
+      "size_bytes": 3834909248
+    },
+    {
+      "relative_path": "3d/canonical-weights/pi3/resolved_config.json",
+      "sha256": "46d3c8fb2a76bc4031894d97920e37a86c75e4a9a4acf478a55735a6e9055dad",
+      "size_bytes": 57
+    },
+    {
+      "relative_path": "3d/canonical-weights/pi3/manifest.json",
+      "sha256": "8a63ae33f1fa126f4b5613a7865a91484ea62c92763905d46040da39688a53d3",
+      "size_bytes": 487
+    }
+  ]
+}

manifest.json

@@ -0,0 +1,16 @@
+{
+  "canonical_file": "3d/canonical-weights/pi3/model.safetensors",
+  "dtype_histogram": {
+    "float32": 1210
+  },
+  "family": "pi3",
+  "normalizer_version": 1,
+  "raw_files": [
+    "3d/models/yyfz233-Pi3/model.safetensors"
+  ],
+  "resolved_config_file": "3d/canonical-weights/pi3/resolved_config.json",
+  "source_checksums": {
+    "3d/models/yyfz233-Pi3/model.safetensors": "33580e4702ac671558aedeab1148fd08118f7ce45bdbeb99f3e3cf340062875d"
+  },
+  "tensor_count": 1210
+}

model.safetensors

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

resolved_config.json

@@ -0,0 +1,4 @@
+{
+  "decoder_size": "large",
+  "pos_type": "rope100"
+}