cliffemu/voxel-render

Voxel Render Space (HF Space #2)

Headless Three.js voxel render service for the Voxel Storybook pipeline.

POST /render with { scene_spec, frame_count, fps, resolution }:

1. 1.Builds the static voxel environment once (instanced meshes), then steps the camera and each moving object per frame using one shared keyframe-interp routine + procedural modifiers (bob / sway / waddle / spin / pulse).
2. 2.Renders one frame at a time via Chromium + SwiftShader WebGL, screenshotting each to a PNG.
3. 3.Tars all frames into a single archive and uploads it to OCI Object Storage (S3-compatible), returning { object_key, frames }. Holds nothing locally.

Required Space secrets

OCI_S3_ENDPOINT, OCI_S3_REGION, OCI_S3_BUCKET, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY (optional OCI_S3_PREFIX, default shots).

Without OCI_S3_BUCKET the service runs in local mode: it writes the tar + frames under LOCAL_OUT and skips the S3 upload (used for local testing).