bintzgavin/helios

helios-studio

Studio tool for developing and previewing Helios compositions.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/bintzgavin/helios --skill helios-studio

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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/
do mesmo repositório

Mais Skills

Todos os Skills
bintzgavin
Comunidade

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

Instalações / 1h
1
GitHub Stars
131
Atualizado
12 de nov.
bintzgavin
Comunidade

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.

Instalações / 1h
1
GitHub Stars
131
Atualizado
12 de nov.
bintzgavin
Comunidade

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

Instalações / 1h
1
GitHub Stars
131
Atualizado
12 de nov.
bintzgavin
Comunidade

example-canvas

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

Instalações / 1h
1
GitHub Stars
131
Atualizado
12 de nov.