bintzgavin/helios

helios-studio

Studio tool for developing and previewing Helios compositions.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/bintzgavin/helios --skill helios-studio

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Helios Studio

The Helios Studio is a Vite-based development server and preview environment. It provides a hot-reloading environment for building compositions and acts as the "Editor" interface for Helios projects.

Quick Start

Run the studio from your project root:

bash
npx @helios-project/cli studio

This will start a local server (typically at http://localhost:5173) where you can view and debug your composition.

Features

Playback & Preview

  • Interactive Timeline: Scrub through your animation frame-by-frame.
  • Hot Reloading: Preserves timeline state (current frame) when you edit code.
  • Audio Controls: Volume slider and Mute toggle.
  • Safe Area Guides: Toggle Action/Title Safe guides and Crosshair.
  • Keyboard Shortcuts:
  • Space: Play/Pause
  • Arrow Left/Right: Step 1 frame
  • Shift + Arrow: Step 10 frames
  • Home: Seek to start
  • I / O: Set In / Out points (Playback Range)
  • L: Toggle Loop

MCP Server

The Studio runs a Model Context Protocol (MCP) server, allowing AI agents to:

  • Inspect composition schemas.
  • Update input props.
  • Trigger renders.
  • Create new compositions.

Props Editor

The Props Editor generates a UI based on your HeliosSchema.

  • Groups: Organize props into collapsible sections using the group schema property.
  • Schema-Aware Inputs:
  • number: Slider (if min/max set), Stepped Slider (if step set).
  • color: Color picker.
  • boolean: Toggle switch.
  • string: Text input or Enum dropdown.
  • image, video, audio, font: Asset selector with preview.
  • model: 3D Model selector (.glb, .gltf).
  • json: JSON file selector.
  • shader: Shader file selector (.glsl).
  • Recursive Support: Generates nested UIs for object and array types.
  • Drag & Drop: Drag assets from the Assets Panel directly into compatible inputs.
  • Metadata Editing: Click "Edit Composition" to change Width, Height, FPS, and Duration.

Assets Management

  • Assets Panel: View and manage files in your assets/ directory.
  • Upload: Drag & drop files onto the panel to upload them.
  • Previews: Rich previews for video (hover-play), audio, fonts, and images.
  • Supported Types:
  • Images: jpg, png, svg, webp
  • Audio: mp3, wav, ogg
  • Video: mp4, webm
  • 3D: glb, gltf
  • Data: json
  • Shaders: glsl, vert, frag

Render Management

  • Renders Panel: Trigger server-side renders directly from the UI.
  • Configuration: Select format (MP4/WebM), resolution, and codec.
  • Progress: Track render progress and cancel jobs if needed.
  • Persistent Jobs: Render history persists across server restarts.
  • Client-Side Export: Export directly from the browser using WebCodecs.

Environment Variables

  • HELIOS_PROJECT_ROOT: Override the root directory scanning path.
bash
  HELIOS_PROJECT_ROOT=./my-project npx @helios-project/cli studio

Common Issues

  • Port in Use: If 5173 is taken, Vite will try the next available port. Check the terminal output.
  • File Not Found: Ensure your composition HTML file exists in the directory or subdirectories of the root.

Source Files

  • CLI Command: packages/cli/src/commands/studio.ts
  • Studio App: packages/studio/
from this repository

More skills

All skills
bintzgavin
Community

animated-video-philosophy

Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic

1h installs
1
GitHub stars
131
Updated
Nov 12
bintzgavin
Community

archive-broll

Find, preview, cut and credit archival B-roll from the Internet Archive (archive.org) for a Helios video — public-domain, CC BY and CC BY-SA film plus Prelinger Archives. Use when a Helios composition needs real footage as a plate, cutaway, masked fill or texture. Not for generating footage or editing the user's own camera video.

1h installs
1
GitHub stars
131
Updated
Nov 12
bintzgavin
Community

cinematic-product-promo-plan

End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished bra

1h installs
1
GitHub stars
131
Updated
Nov 12
bintzgavin
Community

example-canvas

Patterns for using Helios with Vanilla Canvas API. Use when building high-performance 2D/3D animations without frameworks.

1h installs
1
GitHub stars
131
Updated
Nov 12