OrkasVideoStudio
OrkasVideoStudio is an agent-agnostic, MIT-licensed toolkit for driving video composition, generation, and editing.
Verified
Core facts
Read by a script from the official API, not rewritten by a model.
- License
- MIT
- Languages
- TypeScript
- Maintainer
- Orkas-AI
- Homepage
- https://orkas.ai?source=github
- Verified
What it is
OrkasVideoStudio is an agent-agnostic, MIT-licensed toolkit. It drives video composition, generation, and editing. It is not a black-box video agent. The ovs CLI is the canonical interface, and the MCP tools mirror it 1:1.
Main features
The Compose line turns a script into designed HTML motion graphics and then mp4.
The Edit line covers cut, join, trim-silence, de-filler, mix, burn-in subtitles, dub, and localize.
The Generate line produces talking-head or cinematic AI footage and imagery via your own provider.
Generation uses BYO keys for OpenAI, Gemini, and Doubao, with no managed backend and no lock-in.
In the Auto line, stage-plan builds the EDL and stage-assemble walks it.
The compose, edit, and transcribe trunk is zero-key.
Getting started
The prerequisites are Node 22 or newer, and ffmpeg and ffprobe on PATH.
Installing from source works today, while the npm packages are still being published, so installing from npm only works once they are published; the two install blocks are alternatives, and for now only the from-source one is usable.
The registration examples for the MCP server that pull the package from npm likewise only work once the npm packages are published; until then, install from source.
Generation is opt-in and needs your own keys.
The ovs image command supports OpenAI-compatible, Gemini, and Doubao Seedream providers.
The ovs video command supports Doubao Seedance, Atlas Cloud, and MuAPI providers.
The ovs speak TTS command supports OpenAI-compatible providers, including ElevenLabs-style.
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"npm i -g @orkas/video-studio # provides the `ovs` command
ovs doctor # checks ffmpeg/ffprobe/node; guides any installovs skills --install --target claude # → ~/.claude/skills (add --scope repo for ./.claude/skills)
ovs skills --install --target codex # → ~/.agents/skillsclaude mcp add ovs -- npx -y @orkas/video-studio-mcp # Claude Code
codex mcp add ovs -- npx -y @orkas/video-studio-mcp # Codex
# from source (until published): point it at node <repo>/packages/mcp/dist/index.jsovs skills # list the skills
ovs skill video-router # print a skill's full instructions into context
ovs --help # the full command surfaceWho it is for
Reference recreation takes a reference video file and your own product assets, script, or footage. Reference recreation does not include social-platform share-link downloading. The project says compose and edit cost nothing to run.
By default, runs are bounded to up to 6 generated shots and up to 3 recurring characters. The project states this is not a price guarantee. The test:video command is deterministic and never spends provider credits.
The pnpm benchmark command is zero-key and deterministic. OrkasVideoStudio is licensed under MIT. The @orkas/video-studio-mcp package is an MCP server that mirrors the CLI 1:1.
The @orkas/video-studio-skills package is the host-neutral SKILL.md knowledge pack. The @orkas/video-studio-core package contains the IR (schema, validator, delivery guard), decision layer, and runtime/config. The @orkas/video-studio-tools package provides capability backends for render, edit, analyze, speech, image, and video.
Delivery verification fails the check when narration evidence is missing. Caption warnings require visual confirmation when subtitles were burned in. The OVS packages share an independent calendar version.
The ovs speak command writes a request and audio receipt beside its output and reuses only an exact matching request with intact bytes. Revising one shot re-bills one shot.
Sources
This page is written from the official sources below. Open them to check the original text.
- GitHub READMEhttps://github.com/Orkas-AI/Orkas-VideoStudioFetched
Verified ·
This page is written by AI from the official sources above and checked automatically. This site has not tested it. Found a mistake? Tell us.