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부터 지원. 자체 팩토리와 계약을 갖춘 별도의 제품 영역입니다.
업스트림
Tripo AI and Stability AI의 TripoSR, MIT. 논문, 소스
라이선스
코드 MIT and Apache-2.0, 가중치 MIT. 상업적 사용

Install

TripoSR runs on the LibreGen extra, which brings scikit-image for marching cubes.

bash
pip install "libreyolo[gen]"

Predict

Weights download on first use from LibreYOLO/LibreTripoSR, with nothing gated and no login.

Python
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)
CLI
# 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=triposr
Settings
from 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 surface

A 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

SettingDefaultMeaning
resolution256Marching-cubes grid, from 32 to 1024.
threshold25.0Density at the surface.
margin1/0.85Crop 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

작업ONNXTorchScriptExecuTorchTensorRTOpenVINOPaddleMNNRKNNAxelerancnnTFLiteCoreMLCore AI
3D generation3D 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에 있는 저자의 인용 블록에서 복사했습니다.

LibreYOLO v1.8.0에서 검증되었습니다. 이 페이지의 지원 표, 체크포인트, 벤치마크 수치는 출시된 라이브러리와 공개된 가중치에서 생성되며 수동으로 작성되지 않습니다.