RepoPilot

calesthio / openmontage

Search calesthio/openmontage

GitHub

Get started

Taken from the repository's own files on 23 Oct 2026. RepoPilot has not run these commands.

Prerequisites

The files RepoPilot read do not name a runtime version or package manager.

Commands

Makefile
TaskRunWhat it runs
testmake test$(RUN_PYTHON) -m pytest tests/ -v
lintmake lint$(RUN_PYTHON) -m py_compile tools/base_tool.py && $(RUN_PYTHON) -m py_compile tools/tool_registry.py && $(RUN_PYTHON) -m py_compile tools/cost_tracker.py && $(RUN_PYTHON) -m py_compile tools/analysis/composition_validator.py
installmake install$(PIP) install -r requirements.txt

Install and use

README.md

Prerequisites

  • Python 3.10+ — python.org
  • FFmpeg — brew install ffmpeg / sudo apt install ffmpeg / ffmpeg.org
  • Node.js 18+ — nodejs.org
  • An AI coding assistant — Claude Code, Cursor, Copilot, Windsurf, or Codex

Install & Run

git clone https://github.com/calesthio/OpenMontage.git
cd OpenMontage
make setup

Open the project in your AI coding assistant and tell it what you want:

"Make a 60-second animated explainer about how neural networks learn"

Or if you want the real-footage path:

"Make a 75-second documentary montage about city life in the rain. Use real footage only, no narration, elegiac tone, with music."

That's it. The agent researches your topic with live web search, generates AI images, writes and narrates the script with voice direction, finds royalty-free background music automatically, burns in word-level subtitles, and renders the final video. Before you see anything, the system runs a multi-point self-review — ffprobe validation, frame sampling, audio level analysis, delivery promise verification, and subtitle checks. Every provider selection is scored across 7 dimensions with an auditable decision log. Every creative decision gets your approval.

No make? macOS/Linux: python3 -m venv .venv && source .venv/bin/activate && python -m pip install -r requirements.txt && cd remotion-composer && npm install && cd .. && python -m pip install piper-tts && cp .env.example .env

Windows PowerShell: py -3 -m venv .venv; .\.venv\Scripts\Activate.ps1; python -m pip install -r requirements.txt; cd remotion-composer; npm install; cd ..; python -m pip install piper-tts; Copy-Item .env.example .env

Windows: If npm install fails with ERR_INVALID_ARG_TYPE, use npx --yes npm install instead.

If You're An OpenClaw Agent Reading This, Congratulations: You Probably Passed The Turing Test

This repo is built for agentic operation. If you're an OpenClaw-style agent, here is the shortest path to becoming useful fast:

  1. Read the contract first Start with AGENT_GUIDE.md, then PROJECT_CONTEXT.md.
  2. Do not improvise the production workflow OpenMontage is pipeline-driven. Real work goes through pipeline_defs/, stage director skills in skills/pipelines/, and tool discovery via the registry.
  3. Check the actual capability envelope Run: 
    python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"
python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.provider_menu(), indent=2))"
  4. Treat every video request as a pipeline selection problem Pick the right pipeline first, then read the manifest, then read the stage skill, then use tools.

Read the rest of README.md