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
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

  1. The Compose line turns a script into designed HTML motion graphics and then mp4.

  2. The Edit line covers cut, join, trim-silence, de-filler, mix, burn-in subtitles, dub, and localize.

  3. The Generate line produces talking-head or cinematic AI footage and imagery via your own provider.

  4. Generation uses BYO keys for OpenAI, Gemini, and Doubao, with no managed backend and no lock-in.

  5. In the Auto line, stage-plan builds the EDL and stage-assemble walks it.

  6. The compose, edit, and transcribe trunk is zero-key.

Getting started

  1. The prerequisites are Node 22 or newer, and ffmpeg and ffprobe on PATH.

  2. 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.

  3. 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.

  4. Generation is opt-in and needs your own keys.

  5. The ovs image command supports OpenAI-compatible, Gemini, and Doubao Seedream providers.

  6. The ovs video command supports Doubao Seedance, Atlas Cloud, and MuAPI providers.

  7. The ovs speak TTS command supports OpenAI-compatible providers, including ElevenLabs-style.

From the README · bash
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 the README · bash
npm i -g @orkas/video-studio     # provides the `ovs` command
ovs doctor                       # checks ffmpeg/ffprobe/node; guides any install
From the README · bash
ovs skills --install --target claude   # → ~/.claude/skills   (add --scope repo for ./.claude/skills)
ovs skills --install --target codex    # → ~/.agents/skills
From the README · bash
claude 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.js
From the README · bash
ovs skills               # list the skills
ovs skill video-router   # print a skill's full instructions into context
ovs --help               # the full command surface

Who 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.

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.