Meshy Skills cho Hermes Agent

Các skill Meshy chính thức dành cho Hermes Agent cho phép agent của bạn tạo mô hình 3D, texture và hoạt hình cũng như chuẩn bị file in 3D, tất cả chỉ từ một cuộc trò chuyện.

Overview

Meshy hiện đã có mặt trên Hermes Agent, với hai skill:

  • meshy-3d-generation: Văn bản sang 3D, Ảnh sang 3D và đa góc nhìn sang 3D, tạo texture và retexture bằng AI, remesh theo ngân sách đa giác, UV unwrapping, auto-rigging và tạo hoạt hình cho nhân vật dạng người, cùng xuất file sang GLB, FBX, OBJ, STL hoặc USDZ.
  • meshy-3d-printing: phân tích và sửa chữa khả năng in, 3MF đơn sắc và đa sắc, chỉnh kích thước theo tỷ lệ thực tế, các sản phẩm Creative Lab (tượng nhỏ, đèn, móc khóa, nam châm tủ lạnh) và bàn giao cho phần mềm cắt lớp đã cài đặt.

Mỗi skill được cài đặt độc lập, vì vậy bạn có thể chỉ thêm skill in nếu đó là tất cả những gì bạn cần. Cả hai đều vận hành dựa trên Meshy CLI. Bạn chỉ cần đăng nhập một lần trên trình duyệt; không cần khóa API.

Requirements

  • Hermes Agent.
  • Node.js 22.12 trở lên, cùng với npm, trên máy chạy Hermes.
  • Một gói Meshy trả phí để tạo mô hình. Mỗi tác vụ tạo mô hình sẽ tiêu tốn tín dụng Meshy theo mức giá API. Phân tích khả năng in là miễn phí, và các bước in cục bộ, chẳng hạn như thay đổi tỷ lệ mô hình hoặc mở nó trong phần mềm cắt lớp, không cần đăng nhập.

Installation

Cách nhanh nhất là để Hermes tự thực hiện việc cài đặt. Dán nội dung này vào cuộc trò chuyện:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Agent sẽ kiểm tra Node.js, cài đặt Meshy CLI cùng cả hai skill, và hướng dẫn bạn đăng nhập.

Để cài đặt thủ công, hãy thêm các skill từ GitHub bằng Hermes:

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

Hoặc cài đặt cả hai bằng công cụ cài đặt skills:

npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent

Việc cài đặt toàn cục npm install -g meshy-cli là không bắt buộc; nếu không có, các skill sẽ chạy CLI thông qua npm exec. Hãy khởi động một phiên Hermes mới sau khi cài đặt để các skill được nạp.

Sign In

Lần đầu tiên bạn yêu cầu tạo mô hình, agent sẽ chạy quy trình đăng nhập thiết bị của Meshy CLI và gửi cho bạn một liên kết cùng một mã dùng một lần:

  1. Mở liên kết trên bất kỳ thiết bị nào và đăng nhập vào Meshy.
  2. Nhập mã chính xác như hiển thị, sau đó nhấp Connect.
  3. Agent sẽ tiếp tục thực hiện yêu cầu mà bạn đã đưa ra.

Trang kết nối Meshy CLI

Mã sẽ hết hạn sau 10 phút; hãy yêu cầu agent cấp mã mới nếu điều đó xảy ra. Quy trình đăng nhập thiết bị hoạt động từ bất kỳ trình duyệt nào, vì vậy điều này cũng hoạt động khi Hermes chạy trên máy chủ hoặc qua SSH. Meshy CLI lưu trữ phiên đăng nhập tại ~/.config/meshy/credentials.json và chia sẻ nó với mọi agent dưới cùng một tài khoản người dùng. Nếu MESHY_API_KEY được thiết lập, nó sẽ được ưu tiên hơn phiên đăng nhập trình duyệt.

Example Prompts

  • Tạo một mô hình 3D của một chú chó husky con và lưu nó dưới dạng GLB trong ./assets.
  • Biến bức ảnh này thành mô hình 3D có texture và giữ nguyên tỷ lệ của nó. (đính kèm hình ảnh)
  • Tạo ba lọ thuốc độc low-poly cho trò chơi của tôi, mỗi lọ dưới 1.500 tam giác.
  • Rig nhân vật dạng người này, thêm hoạt ảnh đi bộ, và xuất nó dưới dạng FBX.
  • Giúp tôi in 3D một tượng rồng nhỏ, cao 80 mm, dưới dạng 3MF đa sắc.

Các yêu cầu tiếp theo sẽ tái sử dụng kết quả trước đó: tạo một LOD 1.500 mặt, giờ chuyển sang FBX, chỉnh tỷ lệ về 150 mm. Thêm hỏi tôi trước khi tiêu tín dụng để phê duyệt từng bước phải trả phí.

Troubleshooting

Hiện tượngCách khắc phục
Hermes không sử dụng các skill MeshyKhởi động một phiên mới sau khi cài đặt, hoặc nhắc đến Meshy trong yêu cầu của bạn.
Không tìm thấy node hoặc npmCài đặt Node.js 22.12 trở lên từ nodejs.org, sau đó khởi động lại Hermes.
Agent yêu cầu nhập khóa APITừ chối và yêu cầu agent đăng nhập qua trình duyệt thay vào đó. Không bao giờ dán khóa API vào cuộc trò chuyện.
Mã đăng nhập đã hết hạnYêu cầu agent bắt đầu lại quy trình đăng nhập. Mã có hiệu lực trong 10 phút.
Việc tạo mô hình bị từ chối do gói hoặc tín dụngViệc tạo mô hình cần một gói trả phí và đủ tín dụng. Kiểm tra gói và số dư của bạn trên meshy.ai.
Đã đăng nhập sai tài khoản MeshyYêu cầu agent chạy meshy auth logout, sau đó đăng nhập lại.

FAQ

How do I add Meshy to Hermes Agent?
Ask Hermes to follow https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, or run hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation and the same for meshy-3d-printing. You also need Node.js 22.12 or newer with npm.
Do I need a Meshy API key?
No. The skills sign in through your browser with a one-time code, and the Meshy CLI stores the session. If MESHY_API_KEY is already set in your environment, it takes priority.
Can I install only the 3D printing skill?
Yes. meshy-3d-printing installs and works on its own, including the generation steps a print needs.
Does it work when Hermes runs on a remote server?
Yes. The device sign-in shows a link and a code that you can approve from any browser.
Are these the same skills as the Codex plugin?
Yes. The Codex plugin, Claude Code, Cursor and Hermes Agent all use meshy-3d-generation and meshy-3d-printing from the open-source meshy-3d-agent repository.
Is it free?
The skills are free and open source. Generating 3D models requires a paid Meshy plan and spends Meshy credits at API rates. Printability analysis is free.

Related Links