PyVideo Forge

PyVideo Forge is a Python CLI/library for practical video enhancement:

• interpolates motion to 120 or 240 FPS;
• removes consecutive duplicate frames before interpolation;
• upscales and pads video to 4K (3840x2160) by default;
• removes source metadata and chapters;
• keeps audio when present;
• optionally samples frames and asks an OpenAI-compatible vision model for a visual edit brief, including a requested replacement character.

It uses the ffmpeg and ffprobe binaries already available on many server environments. It does not pretend that FFmpeg alone can generate a new anime character into every frame: the analyze command produces a grounded plan for that separate generative-video stage.

Install

pip install pyvideo-forge

Enhance

pyvideo-forge enhance input.mp4 output-4k-240fps.mp4 \
  --fps 240 --width 3840 --height 2160

Use --fps 120 for a faster result. Duplicate frames and source metadata are removed by default.

Analyze with AI

The local probe works without AI. For visual understanding, configure an OpenAI-compatible endpoint and key in the environment, then run:

pyvideo-forge analyze input.mp4 \
  --character "Goku Ultra Instinct"

The package supports AI_INTEGRATIONS_OPENAI_BASE_URL and AI_INTEGRATIONS_OPENAI_API_KEY without printing or persisting their values.

Development

pip install -e ".[dev]"
python -m pytest
python -m build
python -m twine check dist/*