Repolode
Submit
mfranzon

mfranzon/print3d

A Hermes Agent plugin that turns a text idea, a photo or a shop listing into a sliced Bambu Studio project for the Bambu Lab X2D.

View on GitHub
Stars
540
Forks
50
Open issues
12
Last commit
3 days ago

What is it?

print3d is a plugin for Hermes Agent that takes a brief, a photo of an object, or a shop listing and produces a printable Bambu Studio project for the Bambu Lab X2D with a 0.4 mm nozzle. The agent writes a Blender script that builds the part, print3d runs it, checks the mesh for printability, slices it with Bambu Studio's command line, and reports what to fix until all checks pass.

For photos, print3d scales the image from a known reference object, records measurements with their source and tolerance, and compares the generated mesh against the photographed outline. Multi-part designs can be assembled, coloured per part, and checked for interference and fit clearances, which can be calibrated against a test coupon printed on your own printer.

The tool does not send anything to the printer; the final .3mf is opened and printed from Bambu Studio. It also works with Claude Code, Codex, Cursor and Gemini CLI through an MCP server and a command-line interface.

Key features

  • 01Generates a Blender-based model from a text prompt, photo, or shop listing
  • 02Checks overhangs, bed contact, and thin walls before slicing
  • 03Slices through Bambu Studio's command line and reports time, grams and layers
  • 04Scales photos from a reference object and compares the mesh against the outline
  • 05Supports multi-part assemblies with per-part colours and fit checks
  • 06Provides a 3D viewer HTML file and a printable hand-off sheet

Use cases

  • Designing a replacement for a broken household part from a photo and a ruler
  • Making a custom nameplate or small enclosure with a sliding lid
  • Recreating a product from its listing dimensions instead of buying it
  • Preparing a print sheet and project file for a client or print shop

Quick start

  1. 1

    Install Blender, Bambu Studio and uv on the same machine as Hermes

  2. 2

    Install the plugin into Hermes and enable it

    hermes plugins install mfranzon/print3d --enable
  3. 3

    Start a new Hermes session and ask for a part

Things to know

  • Requires Blender 4.2+ and Bambu Studio installed locally, and is built for the Bambu Lab X2D printer.
  • Does not send anything to the printer; you must print from Bambu Studio yourself.
  • The 3D view loads three.js from a CDN, so it needs an internet connection the first time.

In collections

MCP servers

Topics

#3d-printing#bambu-studio#blender#agent-plugin#cad#slicer#mcp#python

FAQ

What is print3d?
A Hermes Agent plugin that turns a text idea, a photo or a shop listing into a sliced Bambu Studio project for the Bambu Lab X2D. print3d is a plugin for Hermes Agent that takes a brief, a photo of an object, or a shop listing and produces a printable Bambu Studio project for the Bambu Lab X2D with a 0.4 mm nozzle. The agent writes a Blender script that builds the part, print3d runs it, checks the mesh for printability, slices it with Bambu Studio's command line, and reports what to fix until all checks pass.
Is print3d free to use? What license does it have?
print3d is open source under the MIT license. Check the license terms before using it in commercial products.
Is print3d still maintained?
Actively maintained. The last commit to print3d was on Nov 4, 2026.
What can I use print3d for?
Designing a replacement for a broken household part from a photo and a ruler Making a custom nameplate or small enclosure with a sliding lid Recreating a product from its listing dimensions instead of buying it Preparing a print sheet and project file for a client or print shop
How do I install print3d?
Install Blender, Bambu Studio and uv on the same machine as Hermes Install the plugin into Hermes and enable it: hermes plugins install mfranzon/print3d --enable Start a new Hermes session and ask for a part
Where can I get print3d?
The source code and installation instructions are on GitHub: https://github.com/mfranzon/print3d

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects