---
license: mit
---

# render_package — 3D Render + Latent Encoding Pipeline

Self-contained portable archive for rendering 3D assets with Blender and encoding them into latent representations (DINOv2, UniLat, TRELLIS SLAT, TRELLIS SS).

## Download & Deploy

```bash
# Download
huggingface-cli download Dennis0626/render_package render_package_portable.tar.gz --local-dir .

# Extract & setup
tar xzf render_package_portable.tar.gz
cd render_package
bash setup.sh                   # extract bundled conda env
source envs/env/bin/activate    # activate
vi config/default.yaml          # set your data paths
```

## Requirements

- Linux x86_64
- NVIDIA GPU with CUDA 12.x drivers (>= 525)
- No conda/pip/internet needed after extraction

## What's inside (~6.9 GiB compressed)

| Component | Size |
|---|---|
| Python pipeline code | ~50K |
| Blender 3.5.1 binary | ~1.2G |
| Model weights (UniLat + TRELLIS + DINOv2) | ~2.1G |
| Third-party model code | ~16M |
| Pre-built conda environment (PyTorch, flash-attn, spconv, open3d, X11/GL) | ~4.5G |

## Usage

```bash
# Multi-GPU encode
SPCONV_ALGO=native python encode_all.py --render_root /path/to/renders --num_gpus 4

# Render .tar.zst shards
python render_github.py --num_shards 10

# Full interleaved pipeline
SPCONV_ALGO=native python run_pipeline.py --render_gpus 0,1 --encode_gpus 2,3
```