Skip to content

BannaWorlds

BannaWorlds is a prompt to world pipeline which turns your generated banana images into 3D explorable worlds, which can be iteratively edited

Code Cerebral Valley

Core trick

Feeds generated images into HunyuanWorld-1.0 to produce explorable 3D worlds that users can iteratively edit.

Tags

creative/musicvision

Description

BannaWorlds is a prompt to world pipeline which turns your generated banana images into 3D explorable worlds, which can be iteratively edited
G-structure/bananaPeel★ 11 forksPythonCreated Sep 6, 2025 · last push Sep 7, 2025

README excerpt

# HunyuanWorld Interactive Demo + BananaPeel Privacy Research

This repository contains two complementary projects:

1. **🌍 HunyuanWorld Interactive Demo** - Immersive 3D world generation from text and images
2. **🛡️ BananaPeel Privacy Research** - Identity protection against image manipulation models

## 🚀 Quick Start

### HunyuanWorld Interactive Demo

Generate immersive 3D worlds using Tencent's HunyuanWorld-1.0 with integrated Nano-Banana reference generation:

#### Web UI (Recommended)
```bash
# Launch immersive web interface with 3D viewer
./scripts/launch_webui.sh
# Open http://127.0.0.1:8000 in your browser
```

#### Gradio UI (Alternative)
```bash
# Launch traditional form-based interface  
uv run python -m banana_peel.ui --mode world
```

#### Command Line
```bash
# Direct HunyuanWorld generation
uv run python adapters/hunyuan_world_runner.py --prompt "cozy studio" --out artifacts/world_001

# Nano-Banana reference generation
uv run python scripts/nano_banana_smoke.py --prompt "futuristic room" --out artifacts/ref_001.png
```

### BananaPeel Privacy Research

Develop and test privacy defenses against identity manipulation:

```bash
# Launch privacy research UI
uv run python -m banana_peel.ui --mode cloak

# Command-line cloaking
uv run python -m banana_peel.cloaker --in image.png --out cloaked.png --mode dct --profile robust

# Evaluation harness
uv run python -m banana_peel.eval_harness_gemini --images assets/images --out results/
```

## 🏗️ Architecture

### Hunyu

Team