videopython

Minimal, LLM-friendly Python library for programmatic video editing, processing, and AI workflows.

Get Started API Reference

from videopython import Video
from videopython.base import FadeTransition

intro = Video.from_path("intro.mp4").resize(1080, 1920)
clip = Video.from_path("raw.mp4").cut(10, 25).resize(1080, 1920).resample_fps(30)
final = intro.transition_to(clip, FadeTransition(effect_time_seconds=0.5))
final = final.add_audio_from_file("music.mp3")
final.save("output.mp4")

Core Editing

Cut, resize, crop, change speed, reverse, freeze frames, picture-in-picture. Combine clips with fade, blur, and instant transitions. Multicam editing for podcast-style recordings.

Effects & Audio

Blur, zoom, color grading, vignette, Ken Burns, text and image overlay. Load, normalize, time-stretch, and mix audio tracks.

LLM-Driven Editing

JSON editing plans with full JSON Schema generation, dry-run validation, and an operation registry with rich constraints.

AI Video Workflows

Generate images, video, speech, and music from prompts. Transcribe, describe scenes, dub to 50+ languages, swap objects.

Installation

pip install videopython          # core editing
pip install "videopython[ai]"    # + local AI features (GPU recommended)

Python >=3.10, <3.14. AI features run locally -- no cloud API keys required.

See the Installation Guide for FFmpeg setup and details.