Repolode
제출하기
zxcHolmes

zxcHolmes/minimax-h3-studio

단일 NVIDIA GPU 머신에서 ComfyUI를 Python 라이브러리로 구동해 오디오·비디오, 이미지, 3D 모델, 음악과 음성을 생성하는 셀프 호스팅 웹 스튜디오입니다.

GitHub에서 보기
스타
187
포크
47
열린 이슈
0
마지막 커밋
그저께

어떤 프로젝트인가요?

MiniMax-H3 Studio는 GPU 머신 한 대에서 MiniMax-H3 오디오·비디오 생성을 실행하는 셀프 호스팅 웹 앱입니다. 노드 UI나 워크플로 JSON 대신 ComfyUI를 Python 라이브러리로 사용하므로, 양자화된 ComfyUI 체크포인트와 ComfyUI의 동적 VRAM 오프로딩을 활용할 수 있으며, 그 앞단에 상시 실행되는 작업 서버와 브라우저 UI를 제공합니다.

이 스튜디오는 텍스트-비디오, 이미지-비디오(첫 프레임 또는 첫 프레임과 마지막 프레임), 최대 6장의 이미지와 3개의 비디오를 활용하는 레퍼런스-비디오 생성을 지원합니다. 또한 MOSS-Image, FLUX.2 Klein 4B, Qwen Image 2.1 Turbo를 사용한 이미지 생성 및 편집, GLB를 내보내는 Pixal3D 기반 이미지-3D 변환, MiniMax Music 3을 이용한 음악 생성, FlashVSR 또는 SeedVR2를 이용한 비디오 업스케일링, 네이티브 audio.cpp CUDA 서버를 통한 음성 기능(TTS, 음성 클로닝, Qwen3-ASR 전사)도 지원합니다. 작업은 영구 큐에서 한 번에 하나씩 실행되며, 작업 사이에도 모델 가중치를 메모리에 유지합니다.

배포 스크립트가 SSH를 통해 GPU 머신에 서버와 UI를 배포하고 systemd 서비스를 설정하며, 별도의 스크립트로 필요한 체크포인트를 다운로드합니다. GPU 호스트에는 사용자가 ComfyUI와 해당 Python 환경을 설치해야 합니다.

핵심 기능

  • 01립싱크와 뮤직비디오용 가이드 오디오를 선택적으로 활용하는 텍스트·이미지·레퍼런스 기반 비디오 생성.
  • 02세 가지 모델을 이용한 이미지 생성 및 편집. 결과물을 편집, 비디오 또는 3D 작업으로 보낼 수 있습니다.
  • 03브라우저 내 뷰어를 제공하고 텍스처가 적용된 GLB 파일을 생성하는 이미지-3D 변환.
  • 04audio.cpp를 통한 음성 합성, 음성 클로닝, 자막 내보내기를 지원하는 전사 기능.
  • 05작업 사이에도 모델 가중치를 메모리에 유지하는 영구 작업 큐.
  • 06GPU 머신에 설치할 때 사용하는 SSH 배포 스크립트와 모델 다운로드 스크립트.

활용 사례

  • RTX급 로컬 GPU에서 사운드가 포함된 짧은 AI 비디오 클립 생성.
  • 각 장면의 사운드트랙으로 곡을 지정해 뮤직비디오 제작.
  • 제품이나 사물 사진 한 장으로 텍스처가 적용된 3D 모델 제작.
  • 자체 하드웨어에서 녹음된 오디오나 비디오를 전사하고 자막 생성.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/<you>/minimax-h3-studio && cd minimax-h3-studio
  2. 2

    로컬 설정 파일을 만들고 편집합니다

    cp .env.example .env
  3. 3

    설정된 모델 체크포인트를 GPU 머신에 다운로드합니다

    ./deploy.sh models
  4. 4

    UI를 빌드하고 서버를 설치한 다음 실행합니다

    ./deploy.sh

사용 전 알아둘 점

  • NVIDIA GPU가 탑재된 Linux 머신이 필요합니다. 이 프로젝트는 VRAM 24 GB의 RTX 4090에서 개발되었습니다.
  • 이 프로젝트는 ComfyUI를 가져오기만 하므로 ComfyUI는 직접 설치해야 합니다.
  • 모델 체크포인트의 총 용량이 수십 GB에 달하므로 다운로드와 디스크 공간에 상당한 비용이 듭니다.
  • cu130보다 오래된 PyTorch에서 가장 빠른 CUDA 백엔드를 사용하려면 comfy_kitchen을 소스에서 빌드하고 ComfyUI에 패치를 적용해야 합니다.

포함된 컬렉션

셀프 호스팅 앱AI 영상·오디오 도구AI 이미지 생성기 & Stable Diffusion 도구

토픽

#ai#video-generation#comfyui#image-generation#text-to-speech#speech-recognition#3d-generation#self-hosted

자주 묻는 질문

minimax-h3-studio은(는) 무엇인가요?
단일 NVIDIA GPU 머신에서 ComfyUI를 Python 라이브러리로 구동해 오디오·비디오, 이미지, 3D 모델, 음악과 음성을 생성하는 셀프 호스팅 웹 스튜디오입니다. MiniMax-H3 Studio는 GPU 머신 한 대에서 MiniMax-H3 오디오·비디오 생성을 실행하는 셀프 호스팅 웹 앱입니다. 노드 UI나 워크플로 JSON 대신 ComfyUI를 Python 라이브러리로 사용하므로, 양자화된 ComfyUI 체크포인트와 ComfyUI의 동적 VRAM 오프로딩을 활용할 수 있으며, 그 앞단에 상시 실행되는 작업 서버와 브라우저 UI를 제공합니다.
minimax-h3-studio은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
minimax-h3-studio은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
minimax-h3-studio은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. minimax-h3-studio의 마지막 커밋은 2026년 11월 6일입니다.
minimax-h3-studio은(는) 어디에 사용할 수 있나요?
RTX급 로컬 GPU에서 사운드가 포함된 짧은 AI 비디오 클립 생성. 각 장면의 사운드트랙으로 곡을 지정해 뮤직비디오 제작. 제품이나 사물 사진 한 장으로 텍스처가 적용된 3D 모델 제작. 자체 하드웨어에서 녹음된 오디오나 비디오를 전사하고 자막 생성.
minimax-h3-studio는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/<you>/minimax-h3-studio && cd minimax-h3-studio 로컬 설정 파일을 만들고 편집합니다: cp .env.example .env 설정된 모델 체크포인트를 GPU 머신에 다운로드합니다: ./deploy.sh models UI를 빌드하고 서버를 설치한 다음 실행합니다: ./deploy.sh
minimax-h3-studio은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zxcHolmes/minimax-h3-studio

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

관련 프로젝트