An open-source, backend-free AI video editor for talking-head video.
Import a clip and the canvas follows your footage — editing, storyboarding, designed graphics, kinetic captions, themes, live preview, timeline and export all run fully in the browser. No account, no server.
This repository is the source for the editor packages plus a minimal shell that mounts them as a plain Vite app. It is synced one-way from the Pireel monorepo; develop against the hosted product at pireel.com.
Quick start
The fastest way to drive Pireel is from your AI coding agent (Codex / Claude Code) — install the plugin and it connects the editor over MCP:
npx skills add pireel/pireel-agent
Or run the editor shell locally:
pnpm install
pnpm dev
Open the printed URL, drop in a video, and start editing. Drafts persist in
localStorage, video bytes in OPFS — nothing leaves the browser.
Themes
Every video can wear a full design system — palette, type and layout dialect.
Dozens ship in @pireel/studio-frames; here are a few.
What works with no backend
- Local editing: talking-head track, blocks, captions, timeline, live preview — all client-side.
- Client export: WYSIWYG export on WebCodecs (Chromium).
- Frame themes: the full catalog is served from
@pireel/studio-frames. - Local uploads: a disk-backed dev route (
/local-assets) stores content-addressed files, the local counterpart of the hosted upload provider.
What needs providers
Generation (block composition, narration planning, transcription, cloud media
vault, cross-device sync, image/video generation) is injected through
StudioProviders. The shell registers unavailableProviders(), so those paths
fail with a hint until you wire them up. Two ways to light them:
- Inject your own providers in
apps/studio-oss/src/providers.ts— five small contracts (composer / planner / transcriber / vault / projects) you can point at any backend or local model. - Bring your own agent: the editor is designed to be driven by an external agent over MCP. See the agent plugin and the connect guide at pireel.com/connect-agent.md.
Layout
apps/studio-oss/ minimal Vite shell that mounts the editor
packages/studio-ui/ editor UI (workbench, panels, timeline, client export)
packages/studio-engine/ composition core, briefs, prompts, video-edit utilities
packages/studio-frames/ frame themes (design systems) + content
packages/ui/ shared primitives, brand mark, theme tokens
Comments