Trải nghiệm khi dùng TRELLIS
Trải nghiệm của TRELLIS giống như một công cụ nghiên cứu hơn là phần mềm đóng gói. Bạn tải mã nguồn, chạy script cài đặt có kèm biên dịch nhiều thành phần, và chờ khá lâu vì số lượng thư viện lớn. Sau khi xong, bạn có thể chạy một đoạn Python ngắn hoặc mở giao diện web mẫu.
Trong giao diện web (viết bằng Gradio), bạn thả một ảnh vật thể, chờ hệ thống tạo vật thể 3D rồi xem bản xoay 360 độ ngay trên trình duyệt. Từ đó bạn có thể xuất file GLB để mở trong Blender hoặc các phần mềm khác. Đoạn mã mẫu cũng xuất video xoay và file PLY của 3D Gaussians.
Ngoài chuyện tạo mới, TRELLIS còn cho phép tạo biến thể của cùng một vật thể hoặc chỉnh sửa cục bộ, ví dụ đổi một phần của vật mà vẫn giữ phần còn lại.
Tính năng nổi bật
Tạo 3D từ ảnh
Mô hình TRELLIS-image-large nhận ảnh làm đầu vào. README khuyên dùng bản ảnh vì cho kết quả tốt hơn bản nhận chữ.
Tạo 3D từ mô tả chữ
Có ba bản TRELLIS-text với kích cỡ khác nhau. README lưu ý nên tạo ảnh bằng một mô hình chữ-thành-ảnh trước rồi đưa vào bản ảnh, vì bản chữ ít sáng tạo và kém chi tiết hơn.
Nhiều dạng đầu ra
Kết quả có thể là 3D Gaussians, radiance field hoặc mesh, rồi xuất ra GLB hoặc PLY để dùng tiếp.
Chỉnh sửa và tạo biến thể
Cho phép sinh nhiều biến thể của cùng một vật hoặc sửa cục bộ một phần của tài sản 3D.
Dùng nhiều ảnh cho một vật
Hỗ trợ điều kiện nhiều ảnh nhìn từ các góc khác nhau mà không cần huấn luyện riêng, tuy README thừa nhận không phải ảnh nào cũng cho kết quả tốt nhất.
Có mã huấn luyện và bộ dữ liệu
Repo mở cả mã huấn luyện và bộ dữ liệu TRELLIS-500K, hữu ích cho nhóm nghiên cứu.
Tận dụng TRELLIS vào việc gì?
Người làm game, hoạ sĩ 3D
Dựng nhanh vật thể cho cảnh 3D
Biến ảnh concept hoặc ảnh vật thật thành mô hình 3D thô để đưa vào Blender, rồi dọn lại topology bằng tay.
Sinh viên, nhà nghiên cứu
Thử nghiệm AI 3D trong nghiên cứu
Đọc code, chạy các ví dụ, tinh chỉnh tham số lấy mẫu để hiểu cách sinh 3D theo cấu trúc thưa.
Nhà thiết kế sản phẩm
Tạo biến thể sản phẩm
Sinh nhiều phiên bản gần giống của một vật để tham khảo ý tưởng tạo hình.
Người làm trải nghiệm tương tác
Làm nguyên liệu cho AR, VR
Xuất GLB để đưa vào công cụ dựng cảnh hoặc ứng dụng xem 3D, sau khi kiểm tra kích thước và chất lượng.
Cần chuẩn bị gì?
- Theo README: chỉ kiểm thử trên Linux; Windows có hướng dẫn góp ý nhưng chưa kiểm thử đầy đủ.
- Card NVIDIA có ít nhất 16 GB bộ nhớ; tác giả kiểm chứng trên A100 và A6000.
- CUDA Toolkit (đã thử với 11.8 và 12.2) để biên dịch các mô đun; nên có Conda quản lý môi trường.
- Python 3.8 trở lên, thời gian cài đặt có thể khá lâu.
Hướng dẫn cài đặt chi tiết
Cài trên Linux (conda)
Cần có Git, Conda và CUDA Toolkit. Tải mã nguồn kèm các submodule.
git clone --recurse-submodules https://github.com/microsoft/TRELLIS.git cd TRELLISChạy script cài đặt. Lệnh dưới tạo một môi trường conda tên trellis và cài toàn bộ thành phần. Có thể chạy lâu; README khuyên kiên nhẫn và thử cài từng cờ một nếu gặp lỗi.
. ./setup.sh --new-env --basic --xformers --flash-attn --diffoctreerast --spconv --mipgaussian --kaolin --nvdiffrastNếu GPU của bạn không hỗ trợ flash-attn, bỏ cờ --flash-attn và đặt biến môi trường ATTN_BACKEND bằng xformers khi chạy, theo hướng dẫn trong README.
Để dùng giao diện web, cài thêm các thư viện cho bản demo.
. ./setup.sh --demo
Cài trên Windows
README ghi rõ mã chỉ được kiểm thử trên Linux, và chỉ dẫn Windows nằm ở một mục thảo luận (issue số 3) của repo, chưa được kiểm thử đầy đủ.
Cách ổn thỏa hơn cho người dùng Windows là dùng WSL2 (Linux chạy trong Windows) có hỗ trợ GPU, rồi làm theo tab Linux. Bạn cần tự kiểm tra WSL2 và driver NVIDIA đã sẵn sàng.
Dùng thử lần đầu
Kích hoạt môi trường conda tên trellis, vào thư mục TRELLIS.
conda activate trellis cd TRELLISChạy giao diện web mẫu rồi mở địa chỉ hiện trong Terminal.
python app.pyThả một ảnh vật thể rõ nét, nền đơn giản vào giao diện, chờ hệ thống tạo 3D rồi xoay thử trên trang.
Xuất file GLB hoặc PLY nếu giao diện có tuỳ chọn tải về, rồi mở bằng Blender để kiểm tra.
Muốn tự viết, chạy file example.py trong repo; nó dựng video xoay từ ba dạng đầu ra và xuất sample.glb cùng sample.ply.
python example.py
Mẹo dùng hay
- Nếu chỉ chạy một lần, README gợi ý đặt SPCONV_ALGO bằng native để tránh bước thử tốc độ ban đầu.
- Luôn ưu tiên mô hình TRELLIS-image-large; mô hình chữ chỉ nên dùng khi bạn không có ảnh.
- Muốn từ chữ ra 3D, hãy tạo ảnh trước bằng một công cụ tạo ảnh rồi đưa vào bản ảnh.
- Nên dọn mesh bằng tay trong Blender; mô hình tạo nhanh nhưng không thay thế được bước chỉnh sửa chuyên nghiệp.
Lưu ý và hạn chế
- Không phù hợp người mới: cài đặt phức tạp, cần Linux, CUDA, trình biên dịch và card 16 GB VRAM trở lên theo tài liệu.
- Chất lượng mô hình sinh ra phụ thuộc ảnh đầu vào; mặt khuất và chi tiết mảnh thường kém chính xác.
- Hãy kiểm tra quyền sử dụng ảnh đầu vào và điều khoản của các mô hình, bộ dữ liệu liên quan trước khi dùng vào sản phẩm thương mại.
Câu hỏi thường gặp
TRELLIS có miễn phí không?
Có. Repo dùng giấy phép MIT và mô hình tải từ Hugging Face. Bạn vẫn nên đọc kỹ điều khoản của từng mô hình trên trang Hugging Face.
Chạy được trên Windows không?
README chỉ kiểm thử trên Linux. Windows có thể thử qua hướng dẫn cộng đồng nhưng không được kiểm thử đầy đủ; dùng WSL2 là phương án phổ biến.
Có bản nhẹ cho card 8 GB không?
README yêu cầu tối thiểu 16 GB bộ nhớ GPU. Nếu card của bạn nhỏ hơn, hãy cân nhắc các dự án khác như Hunyuan3D bản mini hoặc dịch vụ web.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/microsoft/TRELLIS.gitRepo tương tự nên xem
Hunyuan3D 2.0
Tencent-Hunyuan / Hunyuan3D-2
Mô hình AI của Tencent tạo vật thể 3D có màu sắc từ một tấm ảnh, chạy trên máy của bạn
MCP for Blender (blender-mcp)
ahujasid / mcp-for-blender
Nối Claude hay AI khác vào Blender để dựng cảnh 3D, đổi vật liệu và tải mô hình bằng lời dặn
ComfyUI
Comfy-Org / ComfyUI
Tạo ảnh, video, âm thanh bằng AI ngay trên máy bằng cách nối các khối (node) thành quy trình