Repolode
FlashML-org

FlashML-org/FreeVideo

소비자용 GPU에서 VRAM 8GB만으로 MiniMax H3를 실행하는 로컬 동영상 생성 앱이자 ComfyUI 플러그인입니다.

스타
2,814
포크
338
열린 이슈
416
마지막 커밋
어제

어떤 프로젝트인가요?

FreeVideo는 OpenVDN의 8단계 VDN-H3 모델을 기반으로 한 MiniMax H3 동영상 모델용 로컬 추론 엔진입니다. 호스팅 서비스 대신 개인용 GPU에서 직접 동영상을 생성하려는 사용자를 대상으로 합니다. 가중치를 스트리밍하고 비동기적으로 미리 불러온 뒤 청크 단위로 연산해 VRAM, 시스템 메모리, 디스크 사용량을 조율하므로 VRAM 8GB와 RAM 16GB만으로도 생성할 수 있습니다.

이 프로젝트는 전용 크리에이티브 작업 공간을 갖춘 ComfyUI 플러그인으로 제공되며, Windows, macOS(Apple silicon 프리뷰), Linux용 런처도 포함합니다. 런처는 ComfyUI, 런타임, 모델을 설치하며 기존 모델 폴더를 재사용하거나 오프라인으로 설치할 수 있습니다. 텍스트 프롬프트, 첫 프레임과 마지막 프레임, 이미지·동영상·오디오 레퍼런스를 입력으로 사용할 수 있고, 동영상마다 네 가지 품질 수준 중 하나를 선택할 수 있습니다.

핵심 기능

  • 01GPU에 따라 int8 또는 FP8 가중치 형식을 선택합니다.
  • 02가중치 스트리밍과 청크 단위 연산으로 최대 메모리 사용량을 낮춥니다.
  • 03텍스트 프롬프트, 첫 프레임과 마지막 프레임, 이미지·동영상·오디오 레퍼런스를 지원합니다.
  • 04ComfyUI에서 커뮤니티 MiniMax H3 LoRA를 사용할 수 있습니다.
  • 05크리에이티브 작업 공간과 사용자 지정 워크플로를 위한 노드 뷰를 제공합니다.
  • 06런처가 ComfyUI, 런타임, 모델 설치를 처리하며 오프라인 설치도 지원합니다.

활용 사례

  • VRAM 8GB~16GB를 탑재한 가정용 PC에서 짧은 AI 동영상을 생성합니다.
  • 프리뷰 버전으로 Apple silicon 탑재 Mac에서 MiniMax H3를 로컬로 실행합니다.
  • LoRA를 사용해 기존 ComfyUI 파이프라인에 동영상 생성을 추가합니다.
  • Linux 머신에서 생성 서버를 호스팅하고 네트워크로 접속합니다.

빠른 시작

  1. 1

    저장소를 클론하고 해당 폴더를 엽니다

    git clone https://github.com/FlashML-org/FreeVideo.git && cd FreeVideo
  2. 2

    설정 스크립트를 실행하면 FreeVideo, ComfyUI 및 모델이 설치된 다음 브라우저에서 열립니다

    ./setup.sh

사용 전 알아둘 점

  • 모델 가중치에는 지역 및 허용되는 사용에 관한 제한이 있는 MiniMax H3 Community License가 적용됩니다. 코드에 적용되는 Apache-2.0과는 별개입니다.
  • macOS 빌드는 Apple silicon 전용 프리뷰 버전이며 Apple의 공증을 받지 않았으므로, 처음 열 때 macOS에서 차단됩니다.
  • 완전한 오프라인 설치를 위해서는 여러 개의 대용량 모델 팩을 별도로 다운로드해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

FreeVideo은(는) 무엇인가요?
소비자용 GPU에서 VRAM 8GB만으로 MiniMax H3를 실행하는 로컬 동영상 생성 앱이자 ComfyUI 플러그인입니다. FreeVideo는 OpenVDN의 8단계 VDN-H3 모델을 기반으로 한 MiniMax H3 동영상 모델용 로컬 추론 엔진입니다. 호스팅 서비스 대신 개인용 GPU에서 직접 동영상을 생성하려는 사용자를 대상으로 합니다. 가중치를 스트리밍하고 비동기적으로 미리 불러온 뒤 청크 단위로 연산해 VRAM, 시스템 메모리, 디스크 사용량을 조율하므로 VRAM 8GB와 RAM 16GB만으로도 생성할 수 있습니다.
FreeVideo은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
FreeVideo은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
FreeVideo은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. FreeVideo의 마지막 커밋은 2026년 11월 6일입니다.
FreeVideo은(는) 어디에 사용할 수 있나요?
VRAM 8GB~16GB를 탑재한 가정용 PC에서 짧은 AI 동영상을 생성합니다. 프리뷰 버전으로 Apple silicon 탑재 Mac에서 MiniMax H3를 로컬로 실행합니다. LoRA를 사용해 기존 ComfyUI 파이프라인에 동영상 생성을 추가합니다. Linux 머신에서 생성 서버를 호스팅하고 네트워크로 접속합니다.
FreeVideo는 어떻게 설치하나요?
저장소를 클론하고 해당 폴더를 엽니다: git clone https://github.com/FlashML-org/FreeVideo.git && cd FreeVideo 설정 스크립트를 실행하면 FreeVideo, ComfyUI 및 모델이 설치된 다음 브라우저에서 열립니다: ./setup.sh
FreeVideo은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/FlashML-org/FreeVideo

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트