# hy-world-2-0-3d-world-model

A skill for running HY-World 2.0: it turns photos and video into 3D scenes and builds worlds from text or a single image.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 419 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/hy-world-2-0-3d-world-model/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/hy-world-2-0-3d-world-model

## What it does

This skill covers running Tencent Hunyuan's HY-World 2.0 model inside your own project. Two paths are documented. Reconstruction takes a folder of images or a video and returns a point cloud, depth maps, surface normals and 3D Gaussian Splatting attributes. Generation goes the other way: text or one picture becomes a full 3D world through four stages, from panorama to final composition.

WorldMirror 2.0 handles reconstruction. It is a feed-forward model of roughly 1.2B parameters that predicts depth, normals, camera parameters and 3DGS in one pass. Weights arrive from Hugging Face on the first run, but the environment is on you: Python 3.10, PyTorch 2.4.0, CUDA 12.4. Get the CUDA version wrong and the PyTorch install fails, so check your driver first.

Known camera parameters or a depth map can be fed into the pipeline as priors, which sharpens the result. Resolution is adjustable, 512 to 1024 on the shorter edge, and the low setting is the fast one. A Gradio app serves an interactive UI at `http://localhost:7860`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill hy-world-2-0-3d-world-model -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hy-world-2-0-3d-world-model/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hy-world-2-0-3d-world-model/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill hy-world-2-0-3d-world-model -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hy-world-2-0-3d-world-model/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill hy-world-2-0-3d-world-model -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hy-world-2-0-3d-world-model/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills hy-world-2-0-3d-world-model
```

2. **Manually: put the files in place**
- File: `.github/skills/hy-world-2-0-3d-world-model/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill hy-world-2-0-3d-world-model -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/hy-world-2-0-3d-world-model
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hy-world-2-0-3d-world-model/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill hy-world-2-0-3d-world-model -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/hy-world-2-0-3d-world-model/SKILL.md

## When to use it
- build a 3D scene from a folder of photos
- pull frames out of a video and reconstruct a point cloud
- generate a 3D world from a text prompt
- inject known camera parameters to sharpen reconstruction
- batch several scenes and save each result to its own folder

## Example prompts
- Reconstruct a 3D scene from the images in `images/` and save it to `output_3d/`
- Extract frames from `scene.mp4` at 2 fps and run WorldMirror 2.0 on them
- Generate a 3D world from a text description and export the mesh and 3DGS

## Similar
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [media-use](https://affpapa.org/en/nevibecode/skills/media-use.md) — skill · 1100000 installs
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [subagent-driven-development](https://affpapa.org/en/nevibecode/skills/subagent-driven-development.md) — skill · 237746 installs
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 349800 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 139 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md