v6.2.0

Usage

Docker Image

Multi-arch (linux/amd64, linux/arm64) images for this release are published to GHCR and Docker Hub.

Pull

GitHub Container Registry (GHCR):

docker pull ghcr.io/lcy362/free-short-video:6.2.0

Docker Hub:

docker pull lcy362/free-short-video:v6.2.0

Run

Data persistence: the app writes all generated videos, uploads and settings into /app/.working_dir and /app/.agnes_config inside the container. A plain docker run without a volume loses everything when the container is recreated. Mount these paths to your host so outputs survive restarts and can be exported.

Option A — bind mount to a host folder (recommended; files land directly in the folder):

mkdir -p ~/agnes-data/working ~/agnes-data/config
docker run -d -p 8765:8765 \
  -e AGNES_API_KEY=<your-key> \
  -v ~/agnes-data/working:/app/.working_dir \
  -v ~/agnes-data/config:/app/.agnes_config \
  ghcr.io/lcy362/free-short-video:6.2.0

Your videos will be in ~/agnes-data/working/ on your machine.

Option B — named Docker volume (no host path needed; survives container recreation):

docker volume create agnes-working
docker volume create agnes-config
docker run -d -p 8765:8765 \
  -e AGNES_API_KEY=<your-key> \
  -v agnes-working:/app/.working_dir \
  -v agnes-config:/app/.agnes_config \
  ghcr.io/lcy362/free-short-video:6.2.0

Export files from a named volume:

docker run --rm -v agnes-working:/data -v "$PWD":/out busybox cp -r /data/. /out/agnes-export

Then open http://localhost:8765.

Notes

• Prefer Docker Hub? Replace the image with lcy362/free-short-video:v6.2.0.
• The image already declares VOLUME for both paths, so docker run -p 8765:8765 <image> (no -v) keeps data only while you reuse the same container (stop/start); recreating the container starts fresh.
• AGNES_API_KEY can also be set later in the Web UI; it is then stored in the mounted config volume.

npm

Use npx for a one-shot run or install globally:

# Quick run (no install):
npx free-short-video

# Global install:
npm install -g free-short-video
free-short-video

Requires Python 3.10+ and ffmpeg on your system.
On first run, a Python virtual environment is auto-created and dependencies are installed.

---

What's New

Features & Improvements

• Agnes Video 2.5 & 2.5 Flash support — the newest video generation models are now fully supported. Video 2.5 Flash is free for a limited time (720P, $0/sec), while Video 2.5 adds paid quality tiers (720P / 960P / 2K). Both expose new generation modes (text / first-last-frame / image reference), 4–12s durations, and aspect-ratio-based output (21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16).
• Video model selector with capability comparison — video model selection is now open in the settings panel and on the Simple Video form. When choosing a model you see a detailed comparison of all three models (price, generation modes, durations, resolution, negative-prompt support, reference-image limits and reference-video support) before committing.
• Model-aware form options (Simple Video) — the form adapts to the selected model: generation modes, duration presets (v2.0: 5–20s; 2.5-series: 4–12s), resolution control (pixel presets vs. aspect ratio + quality tier with the actual output pixels shown, e.g. 9:16 · 720×1280), and negative-prompt visibility are all driven by the chosen model's capabilities.

Bug Fixes

• 2.5-series keyframe square-output fix — the 2.5 / 2.5-Flash keyframe mode returned a fixed 704×704 square regardless of aspect_ratio, stretching portrait/landscape footage (people appeared wider). Multi-image submissions now automatically fall back to the reference mode so output follows the requested ratio (e.g. 768×1152 input → 704×960 portrait).
• Regression checker F3 resolution validation — the regression suite now validates 2.5-series outputs by aspect ratio instead of absolute pixels, so 720P tier outputs (704×960) are no longer misreported as failures.

---