{
 "slug": "trellis",
 "name": "TRELLIS",
 "author": "Microsoft",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Microsoft's image-to-3D model that outputs meshes, 3D Gaussians or radiance fields from a single image.",
 "category": {
  "slug": "ai-3d",
  "name": "AI 3D model generators"
 },
 "tags": [
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/microsoft.png",
 "logo_letter": "T",
 "links": {
  "repo": "https://github.com/microsoft/TRELLIS",
  "website": "https://huggingface.co/microsoft/TRELLIS-image-large",
  "api_docs": null
 },
 "preview": null,
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Open weights, free to download.",
   "source": {
    "label": "huggingface.co",
    "url": "https://huggingface.co/microsoft/TRELLIS-image-large"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "MIT",
   "quote": "i.e., for research and/or evaluation purposes only.",
   "note": "Models and most code are MIT, but nvdiffrast (used by the GLB export) and diffoctreerast are for research or evaluation only.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/JeffreyXiang/diffoctreerast/blob/master/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/microsoft/TRELLIS/blob/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "Download",
   "status": "info",
   "sub": "Files by hand",
   "quote": null,
   "note": "There is no package or API. Files are downloaded by hand from the official site.",
   "source": {
    "label": "github.com/microsoft/TRELLIS",
    "url": "https://github.com/microsoft/TRELLIS"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT (models and most code); some submodules use other licenses",
  "url": "https://github.com/microsoft/TRELLIS/blob/main/LICENSE",
  "summary": "The models and most of the code are MIT, so they are free to use and share with the notice. Some helper parts used for rendering and for the 3D file export are for research or evaluation only, so check them before paid use.",
  "pages_read": 3,
  "rules": [
   "Model weights are MIT; keep the license notice when you redistribute them.",
   "The diffoctreerast renderer submodule is research and evaluation only; keep it out of commercial pipelines.",
   "Check the modified FlexiCubes submodule license before shipping.",
   "The nvdiffrast (NVIDIA, research or evaluation only) and mip-splatting (research licence) dependencies are not for commercial use."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "With conditions",
    "status": "cond",
    "quote": "i.e., for research and/or evaluation purposes only.",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/JeffreyXiang/diffoctreerast/blob/master/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/microsoft/TRELLIS/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "With conditions",
    "status": "cond",
    "quote": "The following submodules may have different licenses",
    "source": {
     "label": "github.com/microsoft/TRELLIS",
     "url": "https://github.com/microsoft/TRELLIS"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "you include a complete copy of this License with your distribution",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/JeffreyXiang/diffoctreerast/blob/master/LICENSE"
    },
    "note": "The MIT weights may be shared with the notice; diffoctreerast may only be shared with its full license and stays research-only."
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-10",
  "commercial_use_page": "https://agentgid.com/assets/trellis/commercial-use/"
 },
 "overview": {
  "heading": "TRELLIS: 3D models from a single picture",
  "body": "TRELLIS is a free AI model from Microsoft that turns one picture of an object into a 3D model. You can save the result as a ready 3D file, a point-cloud style scene file or a spinning preview video. It runs on a Linux computer with a large graphics card, and some of its helper parts are licensed for research only."
 },
 "uses": [
  {
   "title": "A 3D object from one photo",
   "text": "Give it a single picture of an object, such as a lamp or a figurine. You get a 3D model with colors as a GLB file for games, 3D viewers or Blender.",
   "idea": false,
   "image": null
  },
  {
   "title": "Spinning preview videos",
   "text": "Render a short video that turns around the new object, for a product page, a pitch or a quick review with your team.",
   "idea": false,
   "image": null
  },
  {
   "title": "Scenes for 3D splat viewers",
   "text": "Save the object as a cloud of soft 3D points in a PLY file, which splat viewers on the web can show with fine detail.",
   "idea": false,
   "image": null
  },
  {
   "title": "Variants of the same object",
   "text": "Make several versions of one object, or change one part of it, for example to try different looks for a game item.",
   "idea": false,
   "image": null
  },
  {
   "title": "3D from a text idea",
   "text": "Start from a sentence instead of a photo. The makers advise making a picture first with an image model, then turning that picture into 3D.",
   "idea": false,
   "image": null
  }
 ],
 "start": {
  "prompt": "On my Linux machine with an NVIDIA card of at least 16 GB, set up microsoft/TRELLIS with setup.sh, turn photo.png into photo.glb with TrellisImageTo3DPipeline and to_glb, and list which installed parts are licensed for research only.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "On Linux with an NVIDIA card and the CUDA Toolkit, get the code with its submodules.",
    "source": "git clone --recurse-submodules https://github.com/microsoft/TRELLIS.git\ncd TRELLIS"
   },
   {
    "tab": "Step 2",
    "intro": "Create the conda environment and install the parts you need with the setup script.",
    "source": ". ./setup.sh --new-env --basic --xformers --flash-attn --diffoctreerast --spconv --mipgaussian --kaolin --nvdiffrast"
   },
   {
    "tab": "Step 3",
    "intro": "Load the image model by its Hugging Face name, or from a local folder you downloaded.",
    "source": "TrellisImageTo3DPipeline.from_pretrained(\"microsoft/TRELLIS-image-large\")"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Cloning the code without --recurse-submodules",
   "fix": "git clone --recurse-submodules https://github.com/microsoft/TRELLIS.git",
   "why": "Several renderers come in as submodules and must be compiled; without them the pipeline does not install.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Running on a card without flash-attn support (such as a V100) with default settings",
   "fix": "Install xformers and set ATTN_BACKEND=xformers before running",
   "why": "The default attention backend is flash-attn.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Using the text models for best quality",
   "fix": "Make a picture with an image model first, then use TRELLIS-image-large",
   "why": "The makers say the text models are less creative and detailed.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Treating the whole install as MIT and shipping GLB export in a paid product",
   "fix": "List each installed part's license (nvdiffrast, diffoctreerast, mip-splatting) and get consent or replace the research-only ones",
   "why": "to_glb imports nvdiffrast, and nvdiffrast's license allows non-commercial use only.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Leaving SPCONV_ALGO at auto for a single run",
   "fix": "Set os.environ['SPCONV_ALGO'] = 'native' when you run it only once",
   "why": "The auto setting runs a benchmark first, which only pays off over many runs.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": false,
  "self_serve_text": null,
  "install": null,
  "repo": "https://github.com/microsoft/TRELLIS",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": null,
  "formats": [],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": null,
  "rules_text": "- TRELLIS (AI 3D model generators). Microsoft's image-to-3D model that outputs meshes, 3D Gaussians or radiance fields from a single image. Price: free; commercial use with conditions; no credit needed; ship inside your app with conditions.\n  Connect: download from https://huggingface.co/microsoft/TRELLIS-image-large (no API).\n  Rule: Model weights are MIT; keep the license notice when you redistribute them.\n  Rule: The diffoctreerast renderer submodule is research and evaluation only; keep it out of commercial pipelines.\n  Rule: Check the modified FlexiCubes submodule license before shipping.\n  Rule: The nvdiffrast (NVIDIA, research or evaluation only) and mip-splatting (research licence) dependencies are not for commercial use.\n  License: https://github.com/microsoft/TRELLIS/blob/main/LICENSE (checked 2026-11-10; details: https://agentgid.com/assets/trellis/)",
  "agent_md": "https://agentgid.com/assets/trellis/agent.md",
  "card_json": "https://agentgid.com/assets/trellis/card.json"
 },
 "popularity": {
  "gid_score": 37,
  "stars": 14350,
  "downloads_7d": null,
  "downloads_7d_label": null,
  "downloads_change_4w_pct": null,
  "eco": null,
  "package": null,
  "repo": "microsoft/TRELLIS",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [],
   "stars": [
    [
     "2026-11-07",
     14209
    ],
    [
     "2026-11-08",
     14211
    ],
    [
     "2026-11-09",
     14218
    ],
    [
     "2026-11-10",
     14228
    ],
    [
     "2026-11-11",
     14239
    ],
    [
     "2026-11-12",
     14244
    ],
    [
     "2026-11-13",
     14257
    ],
    [
     "2026-11-14",
     14265
    ],
    [
     "2026-11-15",
     14272
    ],
    [
     "2026-11-16",
     14290
    ],
    [
     "2026-11-17",
     14318
    ],
    [
     "2026-11-18",
     14340
    ],
    [
     "2026-11-19",
     14350
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "trellis",
   "name": "TRELLIS",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "hunyuan3d-2",
   "name": "Hunyuan3D 2.0",
   "why": "Pick Hunyuan3D 2.0 when you also want to paint colors onto models made by hand; its license excludes the EU, the UK and South Korea.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "triposr",
   "name": "TripoSR",
   "why": "Pick TripoSR for fast rough models; its makers cite under 0.5 seconds per model on an A100 graphics card.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "instantmesh",
   "name": "InstantMesh",
   "why": "Pick InstantMesh for a two-step pipeline that first draws several views and then builds a mesh in about 10 seconds.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "shap-e",
   "name": "Shap-E",
   "why": "OpenAI's text-to-3D and image-to-3D model that outputs textured meshes or neural radiance fields.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "point-e",
   "name": "Point-E",
   "why": "Official code and models for generating 3D point clouds from text or images, plus a model that turns point clouds into meshes.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  }
 ],
 "faq": [
  {
   "q": "What files do I get?",
   "a": "A GLB file with a textured mesh, a PLY file with 3D Gaussians, and preview videos of each form."
  },
  {
   "q": "Can I sell the models I make?",
   "a": "The TRELLIS models are MIT. The GLB export imports nvdiffrast, which is for research or evaluation only, so check that part or replace it before paid use."
  },
  {
   "q": "Does it run on a Mac or Windows?",
   "a": "It is tested only on Linux with an NVIDIA card; Windows setups are discussed by the community but not fully tested."
  },
  {
   "q": "Can I use several photos of the same object?",
   "a": "Yes, the picture model accepts several images, but this works without extra training and may not give the best result for every set."
  },
  {
   "q": "Which model should I download?",
   "a": "TRELLIS-image-large (1.2B parameters); the makers recommend the picture models over the text ones, and it also holds all the shared parts."
  }
 ],
 "at_a_glance": {
  "latest_version": "main branch; TRELLIS-image-large weights last changed 2024-12-06",
  "last_commit": "2026-10-27",
  "runtime": "Linux, NVIDIA card with 16 GB or more, CUDA Toolkit (tested 11.8 and 12.2), Python 3.8+",
  "key_needed": false
 },
 "good_to_know": [
  "It needs an NVIDIA graphics card with at least 16 GB of memory and was tested only on Linux.",
  "The GLB export uses NVIDIA's nvdiffrast, whose license allows research or evaluation only. Get NVIDIA's consent or swap it out before selling the results.",
  "The diffoctreerast renderer that comes with it may not be used for commercial purposes without the licensor's consent.",
  "The text-to-3D models give plainer results than the picture model, because of limited training data.",
  "Microsoft has since released TRELLIS.2, a larger 4 billion parameter model that needs a card with 24 GB."
 ],
 "stack_snippets": [],
 "claims": [
  "Trained with up to 2 billion parameters on a set of 500K 3D objects"
 ],
 "checked": {
  "license_read": "2026-11-10",
  "overview_checked": "2026-11-10",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/microsoft/TRELLIS-image-large"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/microsoft/TRELLIS-image-large/raw/main/README.md"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/api/models/microsoft/TRELLIS-image-large"
   },
   {
    "label": "github.com/microsoft/TRELLIS",
    "url": "https://github.com/microsoft/TRELLIS"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/microsoft/TRELLIS/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/microsoft/TRELLIS/blob/main/LICENSE"
   },
   {
    "label": "github.com/microsoft/TRELLIS/blob/main/setup.sh",
    "url": "https://github.com/microsoft/TRELLIS/blob/main/setup.sh"
   },
   {
    "label": "github.com/microsoft/TRELLIS/blob/main/trellis/utils/postprocessing_utils.py",
    "url": "https://github.com/microsoft/TRELLIS/blob/main/trellis/utils/postprocessing_utils.py"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/JeffreyXiang/diffoctreerast/blob/master/LICENSE"
   },
   {
    "label": "github.com/nv-tlabs/FlexiCubes/blob/main/LICENSE.txt",
    "url": "https://github.com/nv-tlabs/FlexiCubes/blob/main/LICENSE.txt"
   },
   {
    "label": "github.com/NVlabs/nvdiffrast/blob/main/LICENSE.txt",
    "url": "https://github.com/NVlabs/nvdiffrast/blob/main/LICENSE.txt"
   },
   {
    "label": "github.com/autonomousvision/mip-splatting/blob/main/LICENSE.md",
    "url": "https://github.com/autonomousvision/mip-splatting/blob/main/LICENSE.md"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/microsoft/TRELLIS.2/blob/main/README.md"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/trellis/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
