# Video-Use — Edit Videos with AI Coding Agents

> An open-source framework from the Browser Use team that lets coding agents edit videos through natural-language instructions, automating cuts, transitions, captions, and effects.

## Install

Save in your project root:

# Video-Use — Edit Videos with AI Coding Agents

## Quick Use
```bash
pip install video-use
video-use "Trim the first 10 seconds and add captions" input.mp4
```

## Introduction
Video-Use is an open-source Python framework from the Browser Use team that enables AI coding agents to edit videos through natural-language instructions. It bridges the gap between text-based agent workflows and multimedia production, turning simple prompts into real video edits.

## What Video-Use Does
- Translates natural-language editing instructions into video processing commands
- Supports trimming, cutting, merging, speed adjustment, and transitions
- Generates and overlays captions and subtitles from speech transcription
- Applies visual effects, filters, and color adjustments via text prompts
- Exports finished videos in standard formats including MP4 and WebM

## Architecture Overview
Video-Use wraps FFmpeg and related media tools behind an agent-friendly Python API. When a coding agent sends editing instructions, Video-Use parses them into a structured edit plan, validates the operations against the input media, and executes them as a pipeline of FFmpeg commands. Speech-to-text integration handles automatic captioning. The framework is designed for headless operation in CI or agent environments.

## Self-Hosting & Configuration
- Install via pip with all dependencies including FFmpeg bindings
- Configure the default output format and resolution in settings
- Set up speech-to-text credentials for automatic caption generation
- Use environment variables to point to custom FFmpeg binaries if needed
- Runs on macOS, Linux, and Windows wherever Python and FFmpeg are available

## Key Features
- Natural-language video editing without manual timeline work
- Automatic caption generation from audio transcription
- Batch processing for editing multiple videos in sequence
- Composable edit pipelines that agents can chain together
- Headless operation for CI/CD and automated content workflows

## Comparison with Similar Tools
- **MoviePy** — Python video editing library requiring explicit code; Video-Use accepts natural-language prompts
- **FFmpeg CLI** — powerful but requires memorizing complex flags; Video-Use abstracts this behind agent-friendly commands
- **Descript** — commercial video editor with AI features; Video-Use is open-source and agent-native
- **Revideo** — code-driven video editor; Video-Use focuses on agent-driven natural-language editing
- **Palmier Pro** — macOS video editor for AI; Video-Use is cross-platform and headless

## FAQ
**Q: Does Video-Use require a GPU?**
A: No. It uses FFmpeg for processing, which runs on CPU. GPU acceleration is optional for certain filters.

**Q: Can it handle long-form video?**
A: Yes. Video-Use processes media in streams rather than loading entire files into memory, supporting videos of any length.

**Q: Which agents work with Video-Use?**
A: Any agent that can invoke Python tools or CLI commands, including Claude Code, Codex, and Cursor.

**Q: Is the caption generation accurate?**
A: Caption quality depends on the speech-to-text provider. Video-Use supports multiple providers including Whisper.

## Sources
- https://github.com/browser-use/video-use


---
Source: https://tokrepo.com/en/workflows/asset-215c806b
Author: AI Open Source