Chuyển đến nội dung

microsoft / TRELLIS

TRELLIS

Mô hình 3D của Microsoft tạo vật thể 3D chất lượng cao từ một ảnh hoặc câu mô tả

TRELLIS là mô hình tạo nội dung 3D của Microsoft Research. Bạn đưa một ảnh (hoặc một câu mô tả) và nhận về tài sản 3D ở nhiều dạng: lưới đa giác (mesh), 3D Gaussians hoặc radiance field, kèm file GLB dùng được trong phần mềm 3D. Repo cung cấp mã nguồn, mô hình tải từ Hugging Face và giao diện web mẫu, nhưng cài đặt khá nặng và README chỉ kiểm thử trên Linux.

  • 14.285 sao
  • 1.428 fork
  • Python
  • Cập nhật 20 ngày trước
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Mô hình AI
Chạy trên
Linux, Python
Chi phí
Miễn phí hoàn toàn

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)

  1. Cần có Git, Conda và CUDA Toolkit. Tải mã nguồn kèm các submodule.

    Terminal
    git clone --recurse-submodules https://github.com/microsoft/TRELLIS.git
    cd TRELLIS
  2. Chạ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.

    Terminal
    . ./setup.sh --new-env --basic --xformers --flash-attn --diffoctreerast --spconv --mipgaussian --kaolin --nvdiffrast
  3. Nế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.

  4. Để dùng giao diện web, cài thêm các thư viện cho bản demo.

    Terminal
    . ./setup.sh --demo

Cài trên Windows

  1. 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 đủ.

  2. 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

  1. Kích hoạt môi trường conda tên trellis, vào thư mục TRELLIS.

    Terminal
    conda activate trellis
    cd TRELLIS
  2. Chạy giao diện web mẫu rồi mở địa chỉ hiện trong Terminal.

    Terminal
    python app.py
  3. Thả 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.

  4. 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.

  5. 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.

    Terminal
    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.

Terminal
git clone https://github.com/microsoft/TRELLIS.git

Repo tương tự nên xem

Tạo ảnh & video bằng AI15,4K

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

KhóWindowsmacOSLinuxPython
MCP: nối AI với công cụ34,6K

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

VừaWindowsmacOSLinuxPython
Tạo ảnh & video bằng AI147K

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

VừaWindowsmacOSLinuxPython

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tạo ảnh & video bằng AI

Tạo ảnh & video bằng AI165K

Stable Diffusion web UI (AUTOMATIC1111)

AUTOMATIC1111 / stable-diffusion-webui

Giao diện web kinh điển để tạo ảnh bằng Stable Diffusion ngay trên máy tính của bạn

VừaWindowsLinuxmacOSPython
Tạo ảnh & video bằng AI144K

MoneyPrinterTurbo

harry0703 / MoneyPrinterTurbo

Nhập chủ đề, tự có video ngắn: kịch bản, giọng đọc, cảnh quay, phụ đề và nhạc

VừaWindowsmacOSLinuxDocker+1
Tạo ảnh & video bằng AI53,9K

Fooocus

lllyasviel / Fooocus

Tạo ảnh AI kiểu Midjourney ngay trên máy bạn, chỉ cần gõ mô tả, ít phải chỉnh thông số

DễWindowsLinuxmacOSPython
Tạo ảnh & video bằng AI52,7K

Upscayl

upscayl / upscayl

Phóng to ảnh mờ, ảnh nhỏ lên nét hơn bằng AI, cài như phần mềm thường, bấm vài nút

DễWindowsmacOSLinux
Tạo ảnh & video bằng AI37,7K

GFPGAN

TencentARC / GFPGAN

AI khôi phục khuôn mặt trong ảnh cũ, ảnh mờ, ảnh do AI tạo ra cho rõ nét hơn

KhóPythonLinuxWindows
Tạo ảnh & video bằng AI37,5K

Real-ESRGAN

xinntao / Real-ESRGAN

Mô hình AI phóng to và làm nét ảnh, video; có bản chạy ngay không cần cài Python

VừaWindowsmacOSLinuxPython

Xem cả 26 repo Tạo ảnh & video bằng AI Về Kho Repo