Hermes Agent 3D Model: Prompt To Finished File In 6 Steps

A Hermes Agent 3D model starts as one sentence in chat and ends as a GLB, FBX, OBJ, STL or USDZ file on your disk, and this is the exact path I'd run to get there.

The engine is the official Meshy plugin from Nous Research, which the Hermes plugin catalog lists at v0.5.0, updated 24 October 2026.

This page skips the plugin tour and walks the full job: prompt, generate, pick a format, clean up in Blender if you need to, then ship the file where it's going.

If you'd rather talk through where 3D assets fit your marketing, book a free SEO strategy session with my team.

The Six-Step Path From Prompt To File

Install and enable the Meshy plugin, then add your Meshy API key.
Decide the output format and detail level before you type the prompt.
Generate from text, one image or several images.
Approve the paid call and wait for the job to finish.
Download the file to a folder you name.
Optionally hand the model to Blender for clean-up or a render.

Every step below maps to something the Meshy plugin README spells out.

Nothing here needs you to write code.

Step 1: Get Hermes Ready To Make 3D Models

Two commands put the plugin in place:

hermes plugins install meshy
hermes plugins enable meshy

The catalog page says the plugin needs Hermes 0.22.3 or newer and runs on Windows, macOS and Linux.

Check your build against the Hermes Agent releases page before you start.

You also need Node.js 18+ with npx on your PATH, because the plugin launches Meshy's own MCP server, pinned at version 0.6.5.

The first start pulls that package into npm's cache, so the very first job is the slowest.

Then the key. Create one at meshy.ai/developers/keys; the README says any paid Meshy plan can create one.

In Hermes Desktop, paste it under Settings → Plugins → Meshy and hit Save. From a terminal, this does the same job:

hermes config set MESHY_API_KEY msy_...

The key lands in your profile's .env, never in config.yaml.

Want the install screens in more detail? Our Hermes Meshy setup walkthrough covers just that part.

Step 2: Pick The Format Before You Prompt

This is the step most people skip, and it's the one the plugin's own skill puts first.

The bundled meshy-3d skill carries Meshy's routing rules, and "choosing the output format first" is one of them.

So decide where the model is going, then tell Hermes in the same sentence.

Where it's going	Format to ask for	Why
Game engine or web viewer	GLB	Every job produces it, and Desktop previews it
Animation or DCC tools	FBX	Listed for refined models
General editing	OBJ with its .mtl and texture	Plain mesh plus material files
3D printer	STL or multicolor 3MF	STL for single colour, 3MF via the multicolor tool
Pipelines that take USDZ	USDZ	Listed for refined models; preview the GLB instead

There's also a detail setting. default_detail accepts ask, game, mobile or detailed.

I'd leave it on ask until you know what your projects usually need.

Step 3: Write The Prompt That Gets A Usable Model

The README gives two starter prompts, and both show the pattern worth copying.

"Make a low-poly treasure chest for Godot" names the object, the style and the destination.

"Turn ~/photos/mug.jpg into a 3D model and get it ready to print at 10 cm" names the source file, the job and a real-world size.

That's the formula: object, style, destination, size.

Behind the scenes Hermes picks from six generation tools: meshy_text_to_3d, meshy_text_to_3d_refine, meshy_image_to_3d, meshy_multi_image_to_3d, meshy_text_to_image and meshy_image_to_image.

No reference photo? Ask for a 2D concept image first, approve the look, then turn that image into the model.

Several photos of the same object from different sides go through the multi-image tool.

🔥 Want the whole Hermes stack already set up, plugins included? Inside the AI Profit Boardroom you get step-by-step video trainings, the installable Agent OS, four coaching calls a week and 3,400+ members building agents like this. → Join the AI Profit Boardroom

Step 4: Approve The Paid Call And Wait It Out

Most Meshy tools spend credits, and Hermes asks before every write-capable call: creates, downloads and cancels.

Read-only calls such as balance, task status and the animation library run without a prompt.

On Hermes builds after v0.22.5 the prompt gives you three answers.

Allow once covers this one call.
Allow for this session covers that tool for the rest of the chat.
Always saves the tool to command_allowlist for every chat in the profile.

Each answer covers one tool only, so allowing text-to-3D doesn't allow rigging.

The plugin also sets a 200-credit spend limit per chat, and a call that would pass it always asks, even for a tool on Always.

Then wait. A Meshy job takes minutes, and meshy_get_task_status waits up to 300 seconds per call.

The plugin declares a 1,500-second call timeout so Hermes doesn't cut those waits off at its 300-second MCP default.

Step 5: Download The File Before It Expires

Here's the gotcha that bites first-timers: Meshy's API assets normally expire after three days.

Viewing a model doesn't save it. Download it.

meshy_download_model writes to the absolute save_to path the agent passes, and the skill asks it to always pass one.

So put the folder in your prompt: "save it to ~/projects/chest/models".

Skip that and the file lands in the plugin's data folder under ~/.hermes/plugin-data/, not your project.

The catalog page adds one safety detail: downloads never write over an existing file.

Every Format A Single Job Gives You

A refined model comes with GLB, FBX, OBJ (with its .mtl and texture), STL and USDZ.

A preview comes with GLB only.

In Desktop, the Download menu on each model card lists those types and saves the one you pick next to the .glb, at no credit cost, because Meshy made them all at generation time.

Formats that weren't produced show a separate Convert action, and that one is a paid conversion through chat.

One known gap: binary USDZ doesn't preview yet in the Desktop viewer, so open the GLB to check the model.

Fixing The Model Without Leaving Hermes

Plenty of clean-up happens inside Meshy before you ever open Blender.

meshy_remesh rebuilds the mesh when the polygon count is wrong for your engine.
meshy_retexture swaps the surface look without regenerating the shape.
meshy_resize sets real-world size, which matters for prints.
meshy_uv_unwrap lays out UVs for texture work.
meshy_convert produces a missing format.

Characters get their own group: meshy_rig, meshy_animate, meshy_text_to_motion and meshy_list_animations.

For rigged or animated models, chat apps also get a short preview video rendered locally.

Step 6: Hand The Model To Blender When You Need More

Meshy has a setting called blender_handoff, labelled "Blender optimized copy", with the values ask, always or never.

If Blender isn't on your PATH or in the usual install folders, point blender_path at it.

For full scene work, add the official Blender plugin, which connects Hermes to the Blender Lab MCP server:

hermes plugins install blender
hermes plugins enable blender

It needs Blender 5.1 or newer on the same machine as the Hermes backend, plus Git and uv.

No Blender yet? The skill offers to install the newest official release from download.blender.org into your own folders, checked against blender.org's sha256 list.

Blender 5.1+ has no build for Intel Macs or Linux on ARM, so plan around that.

Warm the server's uv environment once before the first connection, as the README shows, so a slow first download doesn't time out.

Then confirm a real get_objects_summary response before you treat Blender as ready.

📞 Turning 3D models into pages that rank? Book a free SEO strategy session and my team will map the content and the pages around your product. → Grab your free strategy session

Blender Gotchas I'd Plan For

Blender Lab warns its tools execute arbitrary Python in Blender with no protection against file deletion.

So run experiments in a disposable scene, keep the bridge on loopback, and save your real .blend files elsewhere.

The bridge lives on 127.0.0.1:9876, and Hermes opens Blender with --online-mode so the add-on can start it.

If you open Blender yourself, turn on Allow Online Access or the bridge won't start.

The verified scope is headless: scene read, create, transform, readback and delete passed on Windows ARM64 and x64 with Blender 5.2.2 LTS.

Graphical screenshots aren't verified by the wrapper, so check renders with your own eyes.

Shipping The Model: Engines, Printers, Chat Apps

For a game, take the GLB or FBX straight into the engine you named in the prompt.

For a print, run the printing tools in order: meshy_analyze_printability, meshy_repair_printability, then meshy_auto_split if it's too big, and meshy_send_to_slicer for the handoff.

Need colour on the print? meshy_process_multicolor produces a multicolor 3MF.

Running Hermes in Telegram, Discord or Slack? The agent replies "started, about N min" and ends its turn so the chat isn't blocked.

When the job lands, the thumbnail arrives as a photo and the model file as a document.

Running 3D Jobs On A Schedule

Cron jobs, hermes chat -q and gateways with no approver can't answer the trust prompt.

With default settings, paid calls are refused there. That's the safe default.

To change it, the README lists YOLO mode, an Always answer per tool, or an override in config.yaml that also sets spend_limit.

Setting spend_limit: 0 removes the per-chat cap entirely.

I'd keep a number there, not zero, on any job nobody watches.

Finding Old Models And The Prompt That Made Them

Desktop's Meshy 3D gallery lists recent generations, each labelled with its prompt, and the search box filters by prompt.

Select one and the "Made from" panel shows the prompt, settings, seed, credits and the chain of steps behind it.

For image models and later steps, the plugin logs the creating call in provenance.json, up to 2,000 entries.

That's how you rebuild last month's winning asset without guessing the wording.

My Operator Checklist For Hermes 3D Jobs

Name format, style, destination and size in the first prompt.
Always give a save folder.
Download within three days.
Keep a spend limit on unattended runs.
Use a throwaway Blender scene for agent edits.

Join the AI Profit Boardroom if you want the exact prompts and the Agent OS I run this from.

Also On Our Network

FAQ: Hermes Agent 3D Model

What file formats does a Hermes Agent 3D model come in?

A refined Meshy model comes with GLB, FBX, OBJ with its .mtl and texture, STL and USDZ. A preview comes with GLB only.

Why did my Hermes 3D model disappear after a few days?

Meshy API assets normally expire after three days, and viewing does not save them. Download the file to a folder you name.

Where does Hermes save the model if I do not give a folder?

It lands in the Meshy plugin's data folder under ~/.hermes/plugin-data/, not your project, so always name a save folder in the prompt.

Do I need Blender to make a 3D model with Hermes?

No. Meshy generates, remeshes, retextures, resizes and converts on its own. Blender is for extra scene work or renders.

Can a Hermes cron job make 3D models?

Not with default settings, because unattended runs cannot approve paid calls. YOLO, an Always answer or a config override changes that, with the spend limit still applying unless you remove it.

📺 Video notes + links to the tools 👉

🎥 Learn how I make these videos 👉

🆓 Get a FREE AI Course + Community + 1,000 AI Agents 👉

About Julian

I'm Julian Goldie, an SEO entrepreneur, author and founder of the AI Profit Boardroom, which has 3,400+ members.

I help business owners scale with AI agents, automation and SEO.

I've built a 7-figure SEO and link building agency, Goldie Agency, with a team of 70+ SEO experts.
I've grown a YouTube channel to 400,000+ subscribers.
I wrote "Link Building Mastery".
My Udemy courses have taught over 29,000 students.

→ Get my best AI training inside the AI Profit Boardroom

Pick your format, write the four-part prompt, name a save folder, and if you want help planning the rest, book a free strategy session and start shipping your first Hermes Agent 3D model today.