{
 "slug": "instantmesh",
 "name": "InstantMesh",
 "author": "Tencent ARC",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Image-to-3D pipeline: a multiview diffusion model plus a sparse-view reconstructor that outputs a mesh in about 10 seconds.",
 "category": {
  "slug": "ai-3d",
  "name": "AI 3D model generators"
 },
 "tags": [
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/tencentarc.png",
 "logo_letter": "I",
 "links": {
  "repo": "https://github.com/TencentARC/InstantMesh",
  "website": "https://huggingface.co/TencentARC/InstantMesh",
  "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/TencentARC/InstantMesh",
    "url": "https://huggingface.co/TencentARC/InstantMesh"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "Apache-2.0",
   "quote": "grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce",
   "note": "InstantMesh code and files are Apache-2.0, but the default pipeline loads CC-BY-NC Zero123++ weights and needs the non-commercial nvdiffrast library.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/TencentARC/InstantMesh/blob/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/TencentARC/InstantMesh/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/TencentARC/InstantMesh",
    "url": "https://github.com/TencentARC/InstantMesh"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Apache-2.0",
  "url": "https://github.com/TencentARC/InstantMesh/blob/main/LICENSE",
  "summary": "The InstantMesh code and its own model files are under Apache-2.0, which allows paid use. But the default pipeline also loads a multi-view model whose weights are non-commercial, and a required rendering library is non-commercial too. Check both before any paid use.",
  "pages_read": 1,
  "rules": [
   "Keep the Apache-2.0 license and notices with the code or weights you ship.",
   "Mark files you changed when you redistribute modified code."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/TencentARC/InstantMesh/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/TencentARC/InstantMesh/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/TencentARC/InstantMesh/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "You must cause any modified files to carry prominent notices stating that You changed the files",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/TencentARC/InstantMesh/blob/main/LICENSE"
    },
    "note": "Apache-2.0 allows passing on the InstantMesh code and weights with the license and a note on changed files."
   },
   {
    "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-10-25",
  "commercial_use_page": "https://agentgid.com/assets/instantmesh/commercial-use/"
 },
 "overview": {
  "heading": "InstantMesh: a 3D model from one picture",
  "body": "InstantMesh is free research software from Tencent ARC that turns one picture of an object into a 3D model you can open in 3D tools. It first draws the object from several sides, then builds the shape from those views. It runs on your own computer with an NVIDIA graphics card, not as a web service."
 },
 "uses": [
  {
   "title": "A 3D model from a photo",
   "text": "Take one picture of an object, such as a toy or a product shot. You get a 3D file of it that you can open and edit in Blender or a game engine.",
   "idea": false,
   "image": null
  },
  {
   "title": "Models with a texture image",
   "text": "Get the colors as a separate texture picture instead of colored corners, which most game engines and 3D viewers expect. This takes longer.",
   "idea": false,
   "image": null
  },
  {
   "title": "A local try-out page",
   "text": "Start a small web page on your own machine where you drop a picture and look at the 3D result, before you write any scripts.",
   "idea": false,
   "image": null
  },
  {
   "title": "Pictures that already have no background",
   "text": "If your picture already has a clear, cut-out background, skip the built-in background removal so it does not cut into the object.",
   "idea": false,
   "image": null
  },
  {
   "title": "Rough props for a hobby game",
   "text": "Make quick first versions of props from your own sketches or photos for a student or hobby game, then clean them up by hand.",
   "idea": true,
   "image": null
  },
  {
   "title": "Research on picture-to-3D",
   "text": "Train or fine-tune the models on your own data to compare methods in a study, using the released training code.",
   "idea": false,
   "image": null
  }
 ],
 "start": {
  "prompt": "On my Linux machine with an NVIDIA GPU, set up TencentARC/InstantMesh in a Python 3.10 environment with the exact torch 2.1.0 and xformers 0.0.22.post7 versions from its README, then turn photo.png into a textured .obj with --export_texmap.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "On a computer with an NVIDIA graphics card, create a Python 3.10 environment and install the listed versions of the libraries.",
    "source": "conda create --name instantmesh python=3.10\nconda activate instantmesh\npip install -U pip\nconda install Ninja\nconda install cuda -c nvidia/label/cuda-12.1.0\npip install torch==2.1.0 torchvision==0.16.0 torchaudio==2.1.0 --index-url https://download.pytorch.org/whl/cu121\npip install xformers==0.0.22.post7\npip install -r requirements.txt"
   },
   {
    "tab": "Step 2",
    "intro": "Run the script on a picture. The model files download by themselves on the first run.",
    "source": "python run.py configs/instant-mesh-large.yaml examples/hatsune_miku.png --save_video"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "pip install torch (latest) and xformers (latest), then pip install -r requirements.txt",
   "fix": "Install torch==2.1.0 with the cu121 index and xformers==0.0.22.post7 exactly as the README lists",
   "why": "The pinned diffusers 0.20.2 and the xformers build are matched to PyTorch 2.1.0.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "Expecting a texture image from the default command",
   "fix": "Add --export_texmap when the target tool needs a texture map",
   "why": "The default export stores colors on the mesh corners.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Using --export_texmap with an instant-nerf config at default settings and waiting a long time",
   "fix": "Lower the iso-surface extraction resolution in the config, or use an instant-mesh config",
   "why": "The UV unwrapping step is slow with the NeRF variants at resolution 256.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Treating the Apache-2.0 label on the model page as clearance for a paid product",
   "fix": "Check the Zero123++ weight license (CC-BY-NC 4.0) and the nvdiffrast license before commercial use",
   "why": "The default pipeline loads sudo-ai/zero123plus-v1.2 and needs nvdiffrast, both non-commercial.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": false,
  "self_serve_text": null,
  "install": null,
  "repo": "https://github.com/TencentARC/InstantMesh",
  "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": "3D models made with InstantMesh (Tencent ARC, Apache-2.0) and Zero123++ (CC-BY-NC 4.0 weights)",
  "rules_text": "- InstantMesh (AI 3D model generators). Image-to-3D pipeline: a multiview diffusion model plus a sparse-view reconstructor that outputs a mesh in about 10 seconds. Price: free; commercial use OK; no credit needed.\n  Connect: download from https://huggingface.co/TencentARC/InstantMesh (no API).\n  Rule: Keep the Apache-2.0 license and notices with the code or weights you ship.\n  Rule: Mark files you changed when you redistribute modified code.\n  License: https://github.com/TencentARC/InstantMesh/blob/main/LICENSE (checked 2026-10-25; details: https://agentgid.com/assets/instantmesh/)",
  "agent_md": "https://agentgid.com/assets/instantmesh/agent.md",
  "card_json": "https://agentgid.com/assets/instantmesh/card.json"
 },
 "popularity": {
  "gid_score": 25,
  "stars": 4622,
  "downloads_7d": null,
  "downloads_7d_label": null,
  "downloads_change_4w_pct": null,
  "eco": null,
  "package": null,
  "repo": "TencentARC/InstantMesh",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [],
   "stars": [
    [
     "2026-11-07",
     4591
    ],
    [
     "2026-11-08",
     4593
    ],
    [
     "2026-11-09",
     4593
    ],
    [
     "2026-11-10",
     4596
    ],
    [
     "2026-11-11",
     4598
    ],
    [
     "2026-11-12",
     4599
    ],
    [
     "2026-11-13",
     4601
    ],
    [
     "2026-11-14",
     4601
    ],
    [
     "2026-11-15",
     4601
    ],
    [
     "2026-11-16",
     4603
    ],
    [
     "2026-11-17",
     4613
    ],
    [
     "2026-11-18",
     4620
    ],
    [
     "2026-11-19",
     4622
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "instantmesh",
   "name": "InstantMesh",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "triposr",
   "name": "TripoSR",
   "why": "Pick TripoSR when speed matters most; its makers cite under half a second per picture on a data-center graphics card.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "hunyuan3d-2",
   "name": "Hunyuan3D 2.0",
   "why": "Pick Hunyuan3D 2.0 when you want a separate painting step that adds textures to the generated shape.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "trellis",
   "name": "TRELLIS",
   "why": "Pick TRELLIS when you also want 3D Gaussians or radiance fields, not only meshes, from a single picture.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "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": "Can I run it on a Mac?",
   "a": "Not with the official script. It is set up for NVIDIA graphics cards with CUDA 12.1 or newer."
  },
  {
   "q": "What file do I get?",
   "a": "An .obj model with colors stored on its corners by default, or with a separate texture image when you add --export_texmap."
  },
  {
   "q": "Do I have to download the model files by hand?",
   "a": "No. The script downloads them on the first run; you can also place them in the ckpts folder yourself."
  },
  {
   "q": "Can I use it in a paid product?",
   "a": "The InstantMesh code and files are Apache-2.0, but the default pipeline also relies on non-commercial Zero123++ weights and the non-commercial nvdiffrast library, so check those first."
  },
  {
   "q": "Which model variant is used by default?",
   "a": "The large mesh variant, instant-mesh-large; other variants are picked with a different config file."
  }
 ],
 "at_a_glance": {
  "latest_version": "main at commit 08822c52fdc3 (2025-01-03)",
  "last_commit": "2025-01-03",
  "runtime": "Python 3.10+, PyTorch 2.1.0, CUDA 12.1+, xformers 0.0.22.post7, an NVIDIA GPU; diffusers 0.20.2 and transformers 4.34.1 pinned in requirements.txt; nvdiffrast from GitHub.",
  "key_needed": false
 },
 "good_to_know": [
  "You need a computer with an NVIDIA graphics card. The script is written for such cards and will not run on a regular laptop or a Mac.",
  "The first stage downloads the Zero123++ model from Hugging Face. Its makers say its weights are for non-commercial use only, while its outputs may be used freely.",
  "The InstantMesh files include a changed copy of the Zero123++ image model, so the same non-commercial question applies to it.",
  "The required nvdiffrast library from NVIDIA may only be used for research or evaluation, not for making money.",
  "The code was last changed in January 2025 and pins older library versions, so install exactly the listed versions."
 ],
 "stack_snippets": [],
 "claims": [
  "InstantMesh creates 3D assets within 10 seconds"
 ],
 "checked": {
  "license_read": "2026-10-25",
  "overview_checked": "2026-11-12",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "github.com/TencentARC/InstantMesh",
    "url": "https://github.com/TencentARC/InstantMesh"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/TencentARC/InstantMesh/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/TencentARC/InstantMesh/blob/main/LICENSE"
   },
   {
    "label": "github.com/TencentARC/InstantMesh/blob/main/requirements.txt",
    "url": "https://github.com/TencentARC/InstantMesh/blob/main/requirements.txt"
   },
   {
    "label": "github.com/TencentARC/InstantMesh/blob/main/run.py",
    "url": "https://github.com/TencentARC/InstantMesh/blob/main/run.py"
   },
   {
    "label": "github.com/TencentARC/InstantMesh/blob/main/configs/instant-mesh-large.yaml",
    "url": "https://github.com/TencentARC/InstantMesh/blob/main/configs/instant-mesh-large.yaml"
   },
   {
    "label": "huggingface.co/TencentARC/InstantMesh",
    "url": "https://huggingface.co/TencentARC/InstantMesh"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/TencentARC/InstantMesh/raw/main/README.md"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/api/models/TencentARC/InstantMesh"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/SUDO-AI-3D/zero123plus/blob/main/README.md"
   },
   {
    "label": "github.com/NVlabs/nvdiffrast/blob/main/LICENSE.txt",
    "url": "https://github.com/NVlabs/nvdiffrast/blob/main/LICENSE.txt"
   }
  ],
  "unverified": "Licenses of the third-party models the pipeline downloads (the multiview diffusion stage) were not checked."
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/instantmesh/",
 "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."
}
