OrkasVideoStudio provides an agent-driven, diffable plan-based workflow to compose, edit, and generate videos using local-first components and BYO generation keys. It exposes an ovs CLI and MCP server for agent interaction, with a plan.json as the editable contract.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
OrkasVideoStudio is a toolkit that expresses video production as a readable, diffable, re-renderable plan (plan.json). It bundles knowledge about good video production, deterministic capabilities for render/edit/transcribe/generate (wrappers over hyperframes, ffmpeg, whisper.cpp), and an editable IR. It supports describing a video in plain language to generate a timeline and final file. The four production lines are Compose, Edit, Generate, and Auto, which can be orchestrated end-to-end via a single plan.json.
How it works
The system treats the plan.json as the contract. An agent reads the video-router to lock a line, then executes stage plans (stage-plan, stage-compose, etc.), renders and verifies with a delivery guard (ovs plan promise-check), and outputs the deliverable. Generation is BYO keys, while compose/edit are zero-key/backed by local tools. It provides an MCP-friendly workflow and a deterministic delivery guard prior to delivery.
Getting started
Install requires Node >= 22 and ffmpeg/ffprobe on PATH. The README provides installation from source and from npm:
git clone https://github.com/Orkas-AI/Orkas-VideoStudio.git
cd Orkas-VideoStudio
pnpm install && pnpm build
node packages/cli/dist/index.js doctor # verify ffmpeg/ffprobe/node
# optionally alias it: alias ovs="node $PWD/packages/cli/dist/index.js"
From npm (once published)
npm i -g @orkas/video-studio # provides the `ovs` command
ovs doctor # checks ffmpeg/ffprobe/node; guides any install
Recent releases
- None listed in the latest releases section.
Traction
- Stars: 372
License
MIT
Package overview
- Core: @orkas/video-studio-core (plan.json IR, validator, delivery guard)
- Tools: @orkas/video-studio-tools (render/edit/analyze/speech/image/video backends)
- CLI: @orkas/video-studio
- MCP: @orkas/video-studio-mcp
- Skills: @orkas/video-studio-skills
BYO generation providers
Generation is opt-in with BYO keys; zero-key for compose/edit/transcribe. Config via ~/.config/orkas-video-studio/config.json or OVS_CONFIG_DIR or env vars for providers (image/video/tts).