Permalink to Development GuideDevelopment Guide

Permalink to prerequisitesPrerequisites

Tool	Version	Required for
Node.js	22.12+	everything
pnpm	10.33.x	workspace management; selected by the root `packageManager` field
Python	3.10–3.13	local WhisperX and OpenCV Managed Programs
uv	latest	Python environment management
ffmpeg / ffprobe	recent stable	media processing
Chrome / Chromium	managed by HyperFrames	local HyperFrames rendering

Node.js and pnpm are the only hard requirements. The rest are needed only for live Builds.

Permalink to daily-workflowDaily workflow

bash

corepack enable
pnpm install --frozen-lockfile # after pulling or changing dependencies
pnpm check            # TypeScript type-check
pnpm test             # full test suite

Command	What it runs
`pnpm check`	`tsc -p tsconfig.json --noEmit`
`pnpm test`	package, service-adapter and repository-boundary tests through Node's test runner

See Testing for environment-gated tests and test patterns.

Permalink to repository-layoutRepository layout

text

hypit/
├── packages/              workspace packages
├── docs/                  VitePress documentation site
├── examples/              runnable example sources
├── services/              local media and transcription services
├── test/                  repository boundary tests and shared fixtures
├── package.json           root workspace manifest
├── pnpm-workspace.yaml    package, service and example-component workspaces
└── tsconfig.json          TypeScript config

Permalink to guide-contentsGuide contents

Guide	Topic
Making videos with an Agent	Creative direction, service choices and editable projects
Packages and Extension	Component, model and service ownership; installation and sharing
Adding an author package	Step-by-step: new component, Surface, vocabulary and preview, activation
Models and Providers	Select accounts and APIs; develop a Model or Provider package
Runtime	Profile, Workspace, execution and lifecycle boundaries
Testing	Test runner, patterns, examples, boundary tests
Conventions	Naming, module boundaries, wire data, TypeScript config