Agnes Video Generator

Self-Hosting Deployment Tutorial — 4 Paraan para Patakbuhin ang AI Video Generator nang Libre

Patakbuhin ang Agnes Video Generator sa iyong sariling computer o server: manual, Docker, npm, o AI Agent — pumili ng kahit alin, libre lahat, walang GPU requirement.

Mga Requirement sa Kapaligiran

Bago mag-deploy, siguraduhin na natutugunan ng iyong machine ang mga sumusunod (pwede mong laktawan ito kung pipiliin mo ang Docker — naka-bundle na ang lahat ng dependencies sa image):

  • Python 3.10+ (kailangan para sa manual at npm methods)
  • ffmpeg (kailangan lang sa manual method; naka-bundle na sa Docker at npm)
  • Node.js 18+ (kailangan lang sa npm method)
  • Git (para i-clone ang repository)
  • Walang GPU, walang malaking memory — lahat ng AI computations ay ginagawa sa cloud, sapat na ang ordinaryong laptop

Apat na Paraan ng Deployment

Pumili ng kahit alin para simulan ang service, buksan ang http://localhost:8765 sa browser para gamitin.

Paraan A: Manual Deployment (start.sh)

Ang pinaka-tradisyonal na paraan, para sa mga gustong malaman kung ano ang nangyayari sa bawat hakbang.

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
./start.sh

Awtomatikong gagawa ang script ng virtual environment, mag-i-install ng dependencies, at magbubukas ng browser. Pwede ring i-manual: python3 -m venv .venv && .venv/bin/pip install -r requirements.txt && .venv/bin/python server.py

Paraan B: Docker Deployment

Hindi kailangang mag-install ng Python at ffmpeg — isang command lang at start na. Naka-push ang image sa GHCR at Docker Hub, sumusuporta sa linux/amd64 at linux/arm64.

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

Para sa Docker Hub users, palitan ang image name ng lcy362/free-short-video:latest. Siguraduhing i-mount ang dalawang data directories, kung hindi mawawala ang videos at settings kapag nag-rebuild ng container. Sa PowerShell, palitan ang \ line break ng backtick `.

Paraan C: npm Deployment (CLI)

Isang command lang at tatakbo na ang buong service — hindi na kailangang i-clone ang code o gumawa ng environment, naka-bundle na ang ffmpeg.

npx free-short-video
# o pagkatapos ng global install: free-short-video (short alias: fsv)
AGNES_API_KEY=<iyong-key> npx free-short-video

Mga available na parameter: --port <n> para tukuyin ang port, --host 0.0.0.0 para payagan ang LAN access, --no-open para hindi awtomatikong magbukas ng browser. Sa unang run, awtomatikong gagawa ng virtual environment at mag-i-install ng dependencies.

Paraan D: AI Agent-Assisted Deployment

Dinisenyo ang project para sa AI coding assistants — ipagagawa mo na lang ang deployment sa Agent.

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
# tapos sabihin sa iyong AI Agent:
"Basahin ang AGENTS.md ng project na ito, i-install ang dependencies, i-configure ang API Key, tapos simulan ang service."

May kasamang AGENTS.md deployment guide at four-layer verification checklist ang project — isa-isang susuriin ng Agent ang bawat item at mag-uulat ng resulta.

Mga Senyales na Matagumpay ang Deployment

  • Awtomatikong bubukas ang browser (o manu-manong i-access) ang http://localhost:8765, at makikita ang Agnes Video Generator interface — ibig sabihin, success
  • I-paste ang iyong libreng API Key sa tuktok ng page para makapagsimula nang mag-generate
  • Tinatayang oras ng generation: mga 1-3 minuto para sa simpleng video, mga 10-20 minuto para sa creative long video (5 scenes)

Mga Mahalagang Tandaan

  • Resume support: kung na-interrupt ang service, i-restart lang ito, hanapin ang hindi natapos na task sa task list at i-click ang "Resume" para magpatuloy mula sa huling progress
  • Output directory: lahat ng task outputs ay nasa .working_dir/{timestamp}_{task_id}/, ang final_video.mp4 ang panghuling video (may kasamang narration at subtitles)
  • Port conflict: kung occupied ang port 8765, sa macOS/Linux i-execute ang lsof -ti:8765 | xargs kill; sa Windows gamitin ang netstat -ano | findstr :8765 para hanapin ang PID tapos taskkill
  • May 16 requests-per-minute na API rate limit — ito ay rate limiting para manatiling libre, hindi dahil mabagal ang computer mo

Ayaw mag-install?

Buksan ang opisyal na website at mag-try online nang libre — walang kailangang i-install.

Mag-try Online →

Mga Kaugnay na Pahina

Kumuha ng Libreng Agnes AI API Key — 3-Minute Setup | Libreng AI Video Guide

Ganap na libre ang Agnes AI API keys: kumpletong hakbang sa pag-register, paggawa at pag-copy, tatlong configuration methods (Web UI / env var / API), at 401 troubleshooting.

Text to Video API — Libreng AI Video Generation API, Walang GPU | Agnes Video

Programmatic na tawag sa libreng modelo ng video ng Agnes AI: text-to-video, picture-to-video, narration generation, atbp. Buong saklaw ng REST API, kabilang ang mga parameter ng kahilingan, pagpapatunay ng Bearer, botohan sa katayuan ng gawain at kumpletong mga halimbawa ng code (Python/cURL/HTTP). Developer-friendly, zero-cost, hindi nangangailangan ng high-performance graphics card para ma-access.

Mabilis na Simula: Gabay sa Libreng Video AI

Mula sa pagkuha ng libreng API Key hanggang sa pagbuo ng unang AI video, ang mabilis na gabay sa pagsisimula na ito ay magdadala sa iyo hakbang-hakbang: magparehistro upang makuha ang Key, punan ang pahina, magsulat ng mga prompt na salita, pumili ng mode at tagal, maghintay para sa pag-render, at pag-download sa isang pelikula. Hindi na kailangang magbayad para sa buong proseso, walang high-performance na graphics card, maaari kang magsimula sa loob ng ilang minuto, kahit na walang teknikal na background.

Deployment Documentation

The four deployment methods here (manual / Docker / npm / AI agent) follow the project repo and the official docs below.

  1. agnes-video-generator — 开源 AI 视频生成项目lcy362 · GitHub (2026)

    Deployment scripts like start.sh/server.py and the default port (8765) follow the open-source repository.

  2. FFmpeg Documentation — 音视频处理官方文档FFmpeg 项目 · ffmpeg.org (2025)

    The ffmpeg dependency for manual deployment is covered in the official FFmpeg documentation.

  3. Docker Documentation — 容器化部署Docker · docs.docker.com (2025)

    Building and running the Docker image follows the official Docker documentation.

  4. Node.js — JavaScript 运行时文档OpenJS Foundation · nodejs.org (2025)

    The Node.js 18+ requirement for the npm method is documented on the official Node.js site.

Bakit mapagkakatiwalaan ito

Ang artikulong ito ay isinulat ng mga front-line na practitioner. Kapag isinulat, ang mga unang mapagkukunan tulad ng mga arXiv paper, mga teknikal na ulat ng tagagawa at Stanford AI Index ay na-cross-check, at hindi batay sa mga konklusyon mula sa mga subjective na impresyon.

S

SandGrid@lcy362

Author ng Agnes Video Generator · Full-stack Developer

Independent developer at may-akda ng open source AI Video generation tool na Agnes Video Generator. Ang proyekto ay batay sa ganap na libreng modelo ng video ng Agnes AI at open source ng MIT protocol. Nakatulong ito sa 1,000 creator na gumawa ng mga AI na video sa walang gastos. Matagal na akong binibigyang pansin ang engineering at pagpapasikat ng mga modelo ng pagbuo ng video, at ang nilalaman ng artikulo ay nagmula sa front-line practice at first-hand research.

Tingnan sa GitHub

Huling na-update：2026-08-21

Handa Ka Nang Magsimulang Gumawa?

“Hayaan ang world-class na AI na pag-aari ng lahat.” — Bruce Yang. Ganap na libre, walang credit card o high-performance graphics card, gawin ang iyong unang AI video sa zero cost. Gustong gumamit ng libreng modelo ng video mula sa Agnes AI? Magsimula ka lang dito.

Subukan ang Online DemoMagsimula Nang Libre

I-clone ang GitHub repo at i-launch sa loob ng 2 minuto