mysora/tools/frame_interpolation
hailin 410c20d4fa feat: init my-sora — merge Open-Sora v2.0 (11B) + v1.3 data pipeline tools 2026-03-05 22:53:15 -08:00
..
networks feat: init my-sora — merge Open-Sora v2.0 (11B) + v1.3 data pipeline tools 2026-03-05 22:53:15 -08:00
utils feat: init my-sora — merge Open-Sora v2.0 (11B) + v1.3 data pipeline tools 2026-03-05 22:53:15 -08:00
README.md feat: init my-sora — merge Open-Sora v2.0 (11B) + v1.3 data pipeline tools 2026-03-05 22:53:15 -08:00
__init__.py feat: init my-sora — merge Open-Sora v2.0 (11B) + v1.3 data pipeline tools 2026-03-05 22:53:15 -08:00
interpolation.py feat: init my-sora — merge Open-Sora v2.0 (11B) + v1.3 data pipeline tools 2026-03-05 22:53:15 -08:00

README.md

Frame Interpolation

For current version, we sample 1 frame out of 3 frames in the video. Although we are going to use VAE to avoid frame loss, we provide a frame interpolation tool to interpolate the video now. The frame interpolation tool is based on AMT.

Interpolation can be useful for scenery videos, but it may not be suitable for videos with fast motion.

Requirement

Install the required dependancies by following our installation instructions's "Data Dependencies" and "Frame Interpolation" sections.

Model

We use AMT as our frame interpolation model. After sampling, you can use frame interpolation model to interpolate your video smoothly.

Usage

The ckpt file will be automatically downloaded in user's .cache directory. You can use frame interpolation to your video file or a video folder.

  1. Process a video file
python -m tools.frame_interpolation.interpolation your_video.mp4
  1. Process all video file in target directory
python -m tools.frame_interpolation.interpolation your_video_dir --output_path samples/interpolation

The output video will be stored at output_path and its duration time is equal the total number of frames after frame interpolation / the frame rate

Command Line Arguments

  • input: Path of the input video. Video path or Folder path(with --folder)
  • --ckpt: Pretrained model of AMT. Default path: ~/.cache/amt-g.pth.
  • --niter: Iterations of interpolation. With m input frames, [N_ITER] =n corresponds to 2^n\times (m-1)+1 output frames.
  • --fps: Frame rate of the input video. (Default: 8)
  • --output_path: Folder Path of the output video.