셀프 호스팅 가이드 — AI 영상 생성기를 무료로 실행하는 4가지 방법

시스템 요구사항

배포 전에 다음 요구사항을 확인하세요 (Docker를 선택하면 건너뛸 수 있음 — 이미지에 모든 의존성이 포함되어 있습니다):

• Python 3.10+ (수동 및 npm 방식에 필요)
• ffmpeg (수동 방식만 필요; Docker와 npm에는 내장)
• Node.js 18+ (npm 방식만 필요)
• Git (리포지토리 클론용)
• GPU 불필요, 큰 메모리 불필요 — 모든 AI 연산은 클라우드에서 이루어지며 일반 노트북으로 충분

4가지 배포 방법

하나만 선택하면 서비스가 시작됩니다. 브라우저에서 http://localhost:8765 를 여세요.

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

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

npx free-short-video
# 또는 전역 설치 후 실행: free-short-video (짧은 별칭: fsv)
AGNES_API_KEY=<당신의-키> npx free-short-video

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
# 그런 다음 AI 에이전트에게 말하세요:
"이 프로젝트의 AGENTS.md를 읽고, 의존성을 설치하고, API 키를 설정하고, 서비스를 시작해줘."

배포 성공 확인 방법

• 브라우저가 자동으로 열리거나(또는 http://localhost:8765 방문) Agnes Video Generator 화면이 보이면 성공
• 페이지 상단에 무료 API 키를 붙여넣고 생성 시작
• 소요 시간 참고: 단순 영상 약 1~3분, 크리에이티브 장편(5개 장면) 약 10~20분

사용 팁

• 재개: 서비스가 중단되면 재시작한 뒤 작업 목록에서 미완료 작업의 '재개'를 클릭
• 출력 폴더: 모든 산출물은 .working_dir/{타임스탬프}_{task_id}/ 에 저장. final_video.mp4 가 최종 영상(내레이션·자막 포함)
• 포트 점유: 8765 포트가 사용 중이면 macOS/Linux는 lsof -ti:8765 | xargs kill, Windows는 netstat -ano | findstr :8765 로 PID 확인 후 taskkill
• API 호출은 분당 16회 제한 — 무료 서비스를 유지하기 위한 제한이며, 컴퓨터가 느린 것이 아닙니다