rodin3d-bang-skills

KO | EN

gitlite — search

#python #react #ai #typescript #llm #android #deep-learning #docker #java #windows #kubernetes #security #pytorch #mcp

rodin3d-bang-skills

(★ 16)

No description available.

rodin3d-bang-skills Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Hyper3D BANG Parts Skill

A Codex/Claude skill for generating segmented 3D part files from a single input image or prompt using Hyper3D Rodin Gen-2 plus the BANG API.

## What It Does

This skill exposes a source-to-parts workflow:

1. Submit the image or prompt to Rodin Gen-2 to create the required source asset.
2. Submit that source task UUID to BANG.
3. Poll both asynchronous tasks.
4. Download the resulting BANG part files and write a local manifest.

It is BANG-focused only. Text prompts are supported only as source input for BANG parts; ordinary unsplit model generation is not a user-facing workflow.

## Requirements

- Python 3.7+
- `requests`
- `Pillow`
- Hyper3D API key from [https://hyper3d.ai/api-dashboard](https://hyper3d.ai/api-dashboard)

Install dependencies:

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

Set your API key:

```bash
export HYPER3D_API_KEY=your_api_key_here
```

If no key is provided, the script falls back to the public demo key `vibecoding`.

## Direct Script Usage

```bash
python skills/rodin3d-bang-skill/scripts/generate_banged_parts.py \
  --image /path/to/image.png \
  --output ./output \
  --strength 5 \
  --geometry-file-format glb \
  --material Shaded \
  --resolution Basic
```

Prompt fallback:

```bash
python skills/rodin3d-bang-skill/scripts/generate_banged_parts.py \
  --prompt "a small retro robot with visible arms and legs" \
  --output ./output \
  --strength 5 \
  --geometry-file-format glb \
  --material Shaded \
  --resolution Basic
```

The downloaded files are written to:

```text
./output/<bang_task_uuid>/
```

Each task folder includes `manifest.json` with the Rodin source UUID, BANG UUID, downloaded file paths, and original API download list.

## Parameters

| Parameter | Description | Options | Default |
| --- | --- | --- | --- |
| `--image` | Preferred input image | `.jpg`, `.jpeg`, `.png`, `.webp` | - |
| `--prompt` | Text source fallback | Text | - |
| `--output` | Root output directory | Directory path | `./output` |
| `--strength` | BANG split strength | `2` to `12` | `5` |
| `--geometry-file-format` | BANG part format | `glb`, `usdz`, `fbx`, `obj`, `stl` | `glb` |
| `--material` | BANG material mode | `PBR`, `Shaded`, `All`, `None` | `Shaded` |
| `--resolution` | BANG texture resolution | `Basic`, `High` | `Basic` |
| `--source-quality` | Internal Rodin Gen-2 quality | `high`, `medium`, `low`, `extra-low` | `medium` |
| `--source-mesh-mode` | Internal source mesh mode | `Quad`, `Raw` | `Raw` |
| `--poll-interval` | Seconds between status checks | Integer | `10` |
| `--max-retries` | Checks per async task | Integer | `90` |

## Important API Notes

- BANG requires either a Rodin Gen-2 `asset_id` or a custom uploaded model. This skill creates the Rodin Gen-2 source asset internally and only downloads the BANG result.
- Use `jobs.subscription_key` for status polling.
- Use the top-level `uuid` from BANG for downloads, not `jobs.uuids`.
- Download URLs expire quickly, so the script downloads files immediately.

## Links

- [BANG API docs](https://developer.hyper3d.ai/api-specification/bang)
- [Gen-2 generation docs](https://developer.hyper3d.ai/api-specification/rodin-generation-gen2)
- [Check status docs](https://developer.hyper3d.ai/api-specification/check-status)
- [Download results docs](https://developer.hyper3d.ai/api-specification/download-results)

rodin3d-bang-skills

rodin3d-bang-skills Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

rodin3d-bang-skills

rodin3d-bang-skills Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README