deemostech-rodin3d-skills

Rodin3D Skills

A Skill for generating 3D models from image/multiview images or text prompts using the Hyper3D Rodin Gen-2 API.

Overview

This skill enables AI to generate high-quality 3D models through the Hyper3D Rodin Gen-2 API. It supports both image-to-3D and text-to-3D generation, with multiple output formats and quality tiers.

Features

• Generate 3D models from single or multiple images (up to 5 images)
• Generate 3D models from text descriptions
• Support for multiple output formats: GLB, USDZ, FBX, OBJ, STL
• Five generation tiers: Gen-2, Detail, Smooth, Regular, Sketch
• Automatic task status polling and result retrieval
• Advanced parameters for material, mesh mode, seed values, and more

Installation

Prerequisites

• Claude Code CLI installed
• Hyper3D API Key (obtain from https://hyper3d.ai/api-dashboard)
• Python 3.7+ (for backend scripts)

Method 1: Install from Marketplace (Recommended)

The easiest way to install this skill is through the Claude Code plugin marketplace:

1. Add the marketplace (one-time setup):

   /plugin marketplace add DeemosTech/rodin3d-skills
   

2. Install the plugin:

   /plugin install rodin3d-skill@rodin3d-skills
   

3. Install Python dependencies:

   pip install requests pillow
   

4. Set your API key:

   export HYPER3D_API_KEY=your_api_key_here
   

   Or create a .env file in your project:

   echo 'HYPER3D_API_KEY=your_api_key_here' > .env
   echo '.env' >> .gitignore
   

That's it! The skill is now available as /rodin3d-skill in Claude Code.

Method 2: Manual Installation

If you prefer to install manually or want to develop locally:

1. Clone this repository:

   git clone https://github.com/DeemosTech/rodin3d-skills.git
   cd rodin3d-skills
   

2. Install Python dependencies:

   cd skills/rodin3d-skill
   pip install -r requirements.txt
   

3. Add the local marketplace:

   /plugin marketplace add /path/to/rodin3d-skills
   /plugin install rodin3d-skill@rodin3d-skills
   

4. Set your API key (same as Method 1, step 4)

Verify Installation

After installation, verify the skill is available:

/plugin list

You should see rodin3d-skill in the list of enabled plugins.

Updating the Plugin

To update to the latest version:

/plugin marketplace update rodin3d-skills
/plugin update rodin3d-skill@rodin3d-skills

Usage

Using the Skill

Once installed, you can interact with this skill through:

Generate from image:

Please generate a 3D model from this image: [provide image path]

Generate from text:

Please generate a 3D model of a medieval castle with high quality

Generate from multiple images:

Please generate a 3D model from these images: [provide multiple images]

Direct Script Usage

You can also use the Python scripts directly:

python scripts/generate_3d_model.py \
  --image path/to/image.jpg \
  --geometry-file-format glb \
  --quality medium \
  --output ./output

python scripts/generate_3d_model.py \
  --prompt "A detailed 3D model of a medieval castle" \
  --geometry-file-format glb \
  --quality high \
  --output ./output

Configuration

Generation Tiers

Tier	Description	Use Case	Speed
Gen-2	Highest quality, most advanced	Final production models	Slow
Detail	High detail, high resolution	Models requiring fine details	Medium
Smooth	Clear edges, smooth surface	Simple geometries, stylized models	Medium
Regular	Balanced quality and speed	General purpose	Medium
Sketch	Quick generation, low resolution	Concept validation, quick iteration	Fast

Output Formats

• GLB: Recommended for web and most 3D software
• USDZ: For Apple platforms
• FBX: For game engines and 3D modeling software
• OBJ: Universal 3D format
• STL: For 3D printing

Quality Levels

• High: Best quality, longer processing time
• Medium: Balanced quality and speed
• Low: Faster processing, lower quality
• Extra-low: Fastest processing, minimal quality

Parameters

Basic Parameters

Parameter	Description	Options	Default
--image	Input image path(s) (max 5)	File paths	-
--prompt	Text prompt for generation	Text	-
--tier	Generation tier	Gen-2, Detail, Smooth, Regular, Sketch	Gen-2
--geometry-file-format	Output format	glb, usdz, fbx, obj, stl	glb
--quality	Quality level	high, medium, low, extra-low	medium
--output	Output directory	Directory path	-

Advanced Parameters