TripoSR
TripoSR is a feed-forward image-to-3D model by Tripo AI and Stability AI. It turns one picture of an object into a triplane NeRF in a single pass and returns the object as a vertex-coloured triangle mesh. LibreYOLO runs it through the LibreGen factory in plain PyTorch.
- 작업
- 3d generation
- 설치
pip install "libreyolo[gen]"- 지원 티어
- 별도 티어, v1.8.0부터 지원. 자체 팩토리와 계약을 갖춘 별도의 제품 영역입니다.
- 라이선스
- 코드 MIT and Apache-2.0, 가중치 MIT. 상업적 사용
Install
TripoSR runs on the LibreGen extra, which brings scikit-image for marching cubes.
pip install "libreyolo[gen]"Predict
Weights download on first use from LibreYOLO/LibreTripoSR, with nothing gated and no login.
from libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("triposr") # weights download on first useresult = model(SAMPLE_IMAGE) result.save("object.obj") # vertex colours as `v x y z r g b`m = result.meshesprint(m.vertices[0].shape, m.faces[0].shape) # (V, 3), (F, 3)# Saves the object as .obj under runs/generate/predict.libreyolo generate source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/guggenheim-bilbao.jpg model=triposrfrom libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("triposr")result = model(SAMPLE_IMAGE, resolution=384) # finer marching-cubes gridresult = model(SAMPLE_IMAGE, threshold=25.0) # density at the surfaceA DINO ViT-B/16 encodes the 512 px input, a transformer decodes a triplane
NeRF from it in one pass, and the mesh is the marching-cubes isosurface of the
NeRF's density. There is no sampling, so seed is accepted like every
LibreGen family but changes nothing. It takes about a second on a GPU and runs
in fp32 on NVIDIA GPUs, Apple silicon and CPU.
The source is anything predict takes: a path, URL, PIL image, NumPy array, a folder or a list. An image with real transparency is used as the cutout; anything else has its background removed first with LibreYOLO's BiRefNet port.
result.meshes holds one mesh per object: vertices (V, 3), z-up inside
[-0.5, 0.5]^3, faces (F, 3), and extras["vertex_colors"] (V, 3) RGB in
[0, 1]. The input view looks along -x, so the front of the object faces +x.
save() writes .obj with vertex colours.
Settings
| Setting | Default | Meaning |
|---|---|---|
resolution | 256 | Marching-cubes grid, from 32 to 1024. |
threshold | 25.0 | Density at the surface. |
margin | 1/0.85 | Crop side over object size (upstream's foreground ratio 0.85). |
Marching cubes runs through scikit-image instead of upstream's torchmcubes: the same isosurface, triangulated differently.
Variants
One checkpoint, 0.42B parameters, about 1.7 GB plus 0.4 GB for BiRefNet.
Export
| 작업 | ONNX | TorchScript | ExecuTorch | TensorRT | OpenVINO | Paddle | MNN | RKNN | Axelera | ncnn | TFLite | CoreML | Core AI |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 3D generation | 3D generation to ONNX: 지원하지 않음 | 3D generation to TorchScript: 지원하지 않음 | 3D generation to ExecuTorch: 지원하지 않음 | 3D generation to TensorRT: 지원하지 않음 | 3D generation to OpenVINO: 지원하지 않음 | 3D generation to Paddle: 지원하지 않음 | 3D generation to MNN: 지원하지 않음 | 3D generation to RKNN: 지원하지 않음 | 3D generation to Axelera: 지원하지 않음 | 3D generation to ncnn: 지원하지 않음 | 3D generation to TFLite: 지원하지 않음 | 3D generation to CoreML: 지원하지 않음 | 3D generation to Core AI: 지원하지 않음 |
Export is not implemented for LibreGen 3D families. export(), train() and
val() raise NotImplementedError; their names are reserved by ADR 0031 in
the library.
Licensing
내려받는 특정 가중치의 Hugging Face 저장소에서 라이선스를 확인하십시오. LibreYOLO 조직의 모든 체크포인트에는 라이선스가 있으며 한 계열 안에서도 항상 같지는 않습니다. 해당 저장소가 신뢰할 수 있는 기준입니다. 아래 요약은 이 페이지를 마지막으로 검증했을 때 적용된 내용을 설명합니다.
관련 라이선스에 관한 설명이며 법률 자문이 아닙니다. 상업적으로 중요한 사안이라면 라이선스를 직접 읽고 별도의 법률 자문을 받으십시오.
- 원작
- TripoSR, Tripo AI and Stability AI
- 업스트림 라이선스
- MIT
- LibreYOLO 코드
- MIT
- 가중치
- MIT, huggingface.co/LibreYOLO에 다시 게시됨
- 해석
- MIT is a permissive license, so the code and weights can be used in commercial and closed-source products; the only obligation is to keep the copyright and license notice with copies. LibreYOLO's adapter is MIT; the triplane, NeRF and mesh-extraction code it adapts from TripoSR keeps MIT, and the transformer and DINO ViT encoder follow HuggingFace diffusers and transformers code under Apache-2.0, with their notices in libreyolo/models/gen/triposr/NOTICE. LibreYOLO avoids upstream's torchmcubes (MPL-2.0) by running marching cubes through scikit-image (BSD-3-Clause). The stabilityai/TripoSR weights (MIT) are redistributed unchanged as LibreYOLO/LibreTripoSR; Background removal runs on LibreYOLO's BiRefNet port with the ZhengPeng7/BiRefNet weights (MIT), from LibreYOLO/LibreTRELLISl. Both are pinned and not gated.
TripoSR is by Tripo AI and Stability AI. The code
(VAST-AI-Research/TripoSR) and
the stabilityai/TripoSR weights are MIT, so commercial use is fine with the
copyright notice kept. LibreYOLO redistributes the weights unchanged as
LibreYOLO/LibreTripoSR. It avoids upstream's torchmcubes (MPL-2.0) by using
scikit-image (BSD-3-Clause); the BiRefNet background remover weights are MIT.
Citation
@article{TripoSR2024,
title={TripoSR: Fast 3D Object Reconstruction from a Single Image},
author={Tochilkin, Dmitry and Pankratz, David and Liu, Zexiang and Huang, Zixuan and and Letts, Adam and Li, Yangguang and Liang, Ding and Laforte, Christian and Jampani, Varun and Cao, Yan-Pei},
journal={arXiv preprint arXiv:2403.02151},
year={2024}
}github.com/VAST-AI-Research/TripoSR#citation에 있는 저자의 인용 블록에서 복사했습니다.