FerrisMind commited on
Commit
ea6d879
·
verified ·
1 Parent(s): 069cff2

Delete README.md

Browse files
Files changed (1) hide show
  1. README.md +0 -99
README.md DELETED
@@ -1,99 +0,0 @@
1
- ---
2
- license: mit
3
- pipeline_tag: image-to-3d
4
- base_model: stabilityai/TripoSR
5
- tags:
6
- - lux3d
7
- - rust
8
- - candle
9
- - safetensors
10
- - canonical-weights
11
- - 3d
12
- - image-to-3d
13
- - mesh-generation
14
- - triposr
15
- ---
16
-
17
- # Lux3D TripoSR Canonical Weights
18
-
19
- This repository contains the canonicalized `safetensors` export of the TripoSR checkpoint used by the Lux3D `3d-rs` runtime.
20
-
21
- The package converts the original TripoSR checkpoint/config pair into a stable runtime layout with explicit provenance and integrity metadata.
22
-
23
- ## Model Details
24
-
25
- - Model family: `triposr`
26
- - Canonical file: `model.safetensors`
27
- - Tensor count: `549`
28
- - Primary runtime target: Lux3D `3d-rs`
29
- - Typical output: mesh export (`.obj`)
30
-
31
- ## Included Files
32
-
33
- - `model.safetensors`: canonical model weights for runtime loading
34
- - `resolved_config.json`: normalized JSON snapshot of the effective TripoSR config
35
- - `manifest.json`: provenance metadata for the canonical package
36
- - `checksums.json`: integrity data for the files in this package
37
-
38
- ## Usage With Lux3D
39
-
40
- This folder is designed to be uploaded as a standalone Hugging Face model repository and then restored into:
41
-
42
- ```text
43
- <repo-root>/3d/canonical-weights/triposr/
44
- ```
45
-
46
- The Lux3D CLI will validate and use the package. The example below assumes you run it from the `3d-rs/` directory:
47
-
48
- ```powershell
49
- cargo run -p lux3d-cli -- inspect --repo-root .. triposr
50
- cargo run -p lux3d-cli -- run --repo-root .. triposr --source ../tp/3d/TripoSR/examples/horse.png --mc-resolution 256 --mc-threshold 25.0 --output ../3d/_generated/triposr.obj
51
- ```
52
-
53
- ## Provenance
54
-
55
- - Upstream source model: [`stabilityai/TripoSR`](https://huggingface.co/stabilityai/TripoSR)
56
- - Canonicalization flow: `3d-rs/tools/python_baseline/normalize_weights.py`
57
- - Raw source files expected by Lux3D before normalization:
58
- - `3d/models/stabilityai-TripoSR/model.ckpt`
59
- - `3d/models/stabilityai-TripoSR/config.yaml`
60
-
61
- The exact source checksum set is recorded in `manifest.json`. The integrity of the uploaded package is recorded in `checksums.json`.
62
-
63
- ## Intended Use
64
-
65
- This package is intended for:
66
-
67
- - single-image 3D reconstruction in Lux3D
68
- - mesh generation workflows using TripoSR canonical weights
69
- - reproducible local/runtime validation
70
-
71
- This package is not meant to replace the full upstream TripoSR repository. It is the runtime-focused canonical weight package for Lux3D.
72
-
73
- ## Limitations
74
-
75
- - Verified Lux3D inference currently assumes CUDA.
76
- - This package includes canonical runtime artifacts only.
77
- - Texture baking and other extended upstream utilities are outside the scope of this package.
78
-
79
- ## License
80
-
81
- The upstream TripoSR model and code are distributed under MIT.
82
-
83
- - Upstream model page: [`stabilityai/TripoSR`](https://huggingface.co/stabilityai/TripoSR)
84
- - Local package notice: [LICENSE](LICENSE)
85
-
86
- Retain upstream attribution when redistributing the package.
87
-
88
- ## Citation
89
-
90
- If you use TripoSR in research, cite the upstream work:
91
-
92
- ```bibtex
93
- @article{tripoSR2024,
94
- title={TripoSR: Fast 3D Object Reconstruction from a Single Image},
95
- author={Tochilkin, Dmitry and Pankratz, David and Liu, Zexiang and Huang, Zixuan and Letts, Adam and Li, Yangguang and Liang, Ding and Laforte, Christian and Jampani, Varun and Cao, Yan-Pei},
96
- journal={arXiv preprint arXiv:2403.02151},
97
- year={2024}
98
- }
99
- ```