CRM
CRM (Convolutional Reconstruction Model) is Tsinghua University's image-to-3D model. Two multi-view diffusion models generate six views of the object and their coordinate maps, a convolutional UNet turns them into a triplane, and FlexiCubes extracts a coloured mesh. LibreYOLO runs it in plain PyTorch through the LibreGen factory.
- 작업
- 3d generation
- 설치
pip install "libreyolo[gen]"- 지원 티어
- 별도 티어, v1.8.0부터 지원. 자체 팩토리와 계약을 갖춘 별도의 제품 영역입니다.
- 라이선스
- 코드 MIT and Apache-2.0, 가중치 CreativeML OpenRAIL++-M. 상업적 사용
Install
pip install "libreyolo[gen]"texture=True also needs the MIT-licensed xatlas package
(pip install xatlas) for the UV unwrap.
Predict
Nothing is gated and no login is needed. Weights download on first use from LibreYOLO/LibreCRM at a pinned revision.
from libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("crm") # weights download on first useresult = model(SAMPLE_IMAGE, seed=0) result.save("object.obj") # vertex colours as `v x y z r g b`m = result.meshesprint(m.vertices[0].shape, m.extras["vertex_colors"][0].shape)# 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=crm seed=0libreyolo generate source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/guggenheim-bilbao.jpg model=crm texture=true# pip install xatlas (MIT, for the UV unwrap)from libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("crm")model(SAMPLE_IMAGE, texture=True).save("object.obj")# writes object.obj, object.mtl and object_texture.pngTwo multi-view diffusion models generate six orthographic views of the object and then their canonical coordinate maps; a convolutional UNet turns them into a triplane, and FlexiCubes extracts a mesh coloured by the triplane. Upstream needs xformers, nvdiffrast (NVIDIA, non-commercial) and a GPL mesh library; LibreYOLO runs the same weights in plain PyTorch on NVIDIA GPUs, Apple silicon and CPU, in fp16 on the GPUs as upstream.
The input is padded to a square on grey, without a crop, so a photo works best with the object filling the frame. A seed gives the same starting noise on every device; on CUDA a repeat call gives the same views and triangles, with vertices that can move by about 1e-7. The library measured about 12 s and 12 GB per object on an RTX 3090.
result.meshes holds vertices (V, 3), z-up in [-0.5, 0.5]^3, faces
(F, 3) and extras["vertex_colors"] (V, 3) RGB in [0, 1].
texture=True bakes a 1024 x 1024 UV texture, as upstream does.
Settings
| Setting | Default | Meaning |
|---|---|---|
steps | 50 | Sampling steps of both diffusion stages, 1 to 499. |
guidance | 5.0 | Classifier-free guidance of both stages. |
texture | False | Bake a UV texture (.mtl and .png beside the .obj). |
Variants
One checkpoint, 4.1B parameters: two 2.0B multi-view diffusion models (UNet, OpenCLIP ViT-H/14 and SD VAE each) and a 0.12B reconstruction UNet. About 12.8 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 (ADR 0031 in the library).
Licensing
내려받는 특정 가중치의 Hugging Face 저장소에서 라이선스를 확인하십시오. LibreYOLO 조직의 모든 체크포인트에는 라이선스가 있으며 한 계열 안에서도 항상 같지는 않습니다. 해당 저장소가 신뢰할 수 있는 기준입니다. 아래 요약은 이 페이지를 마지막으로 검증했을 때 적용된 내용을 설명합니다.
관련 라이선스에 관한 설명이며 법률 자문이 아닙니다. 상업적으로 중요한 사안이라면 라이선스를 직접 읽고 별도의 법률 자문을 받으십시오.
- 원작
- CRM, Tsinghua University (TSAIL)
- 업스트림 라이선스
- CreativeML OpenRAIL++-M
- 업스트림 소스
- github.com/thu-ml/CRM
- LibreYOLO 코드
- MIT
- 가중치
- CreativeML OpenRAIL++-M, huggingface.co/LibreYOLO에 다시 게시됨
- 해석
- The CRM code is MIT and its model card declares MIT for the weights, but CRM's two diffusion models are fine-tuned from ImageDream and MVDream, themselves from Stable Diffusion 2.1, so LibreYOLO treats the weights as under the CreativeML OpenRAIL++-M License of that lineage. OpenRAIL++-M allows commercial use, but its use-based restrictions (no illegal, harmful, discriminatory or deceptive uses, among others) bind you and must be passed on to anyone you share the model or derivatives with. LibreYOLO's adapter is MIT; the code it adapts from CRM is MIT, the FlexiCubes meshing comes from NVIDIA's Apache-2.0 release, and ImageDream parts are Apache-2.0, noted in libreyolo/models/gen/crm/NOTICE. CRM's own FlexiCubes copies with NVIDIA's all-rights-reserved header, nvdiffrast (non-commercial) and the GPL-3.0 mesh tools upstream calls are not used. The Zhengyi/CRM weights are redistributed unchanged as LibreYOLO/LibreCRM, whose card carries the OpenRAIL++-M terms; Background removal runs on LibreYOLO's BiRefNet port with the ZhengPeng7/BiRefNet weights (MIT), from LibreYOLO/LibreTRELLISl. Both are pinned and not gated.
CRM is by Tsinghua University (TSAIL) (thu-ml/CRM). The code is MIT and the model card declares MIT for the weights.
The weights carry use restrictions. CRM's two diffusion models descend from ImageDream, MVDream and Stable Diffusion 2.1, so LibreYOLO treats them as under the CreativeML OpenRAIL++-M License of that lineage. Commercial use is allowed, but its use-based restrictions (no illegal, harmful, discriminatory or deceptive uses, among others) bind you and must be passed on to anyone you share the model or derivatives with.
The Zhengyi/CRM weights are redistributed unchanged as LibreYOLO/LibreCRM,
whose card carries the OpenRAIL++-M terms. FlexiCubes comes from NVIDIA's
Apache-2.0 release; nvdiffrast and the GPL-3.0 mesh tools upstream calls are
not used.
Citation
@article{wang2024crm,
title={CRM: Single Image to 3D Textured Mesh with Convolutional Reconstruction Model},
author={Zhengyi Wang and Yikai Wang and Yifei Chen and Chendong Xiang and Shuo Chen and Dajiang Yu and Chongxuan Li and Hang Su and Jun Zhu},
journal={arXiv preprint arXiv:2403.05034},
year={2024}
}github.com/thu-ml/CRM#citation에 있는 저자의 인용 블록에서 복사했습니다.