HKUDS/ViMax

어떤 프로젝트인가요?

핵심 기능

• 01짧은 아이디어에서 대본, 스토리보드, 샷을 포함한 완성된 영상을 생성합니다.
• 02구체적인 각본을 여러 장면과 샷으로 구성된 영상으로 변환합니다.
• 03장편 소설을 에피소드 형식의 시각적 이야기로 각색합니다.
• 04생성된 장면 전반에서 사람이나 반려동물의 외모를 일관되게 유지합니다.
• 05기획, 수정, 렌더링 제어를 위한 대화형 TUI와 로컬 Web UI를 제공합니다.
• 06서로 호환되는 샷과 미디어 에셋을 병렬로 생성합니다.

활용 사례

• 글로 작성한 콘셉트로 단편 영화나 예고편을 빠르게 시안 제작합니다.
• 각본을 검토용 멀티샷 영상으로 변환합니다.
• 소설의 한 장을 에피소드 형식의 애니메이션 스타일 영상으로 각색합니다.
• 사용자의 사진이 등장하는 맞춤형 단편 이야기를 만듭니다.

빠른 시작

1. 1

   uv를 설치합니다(README에 링크된 uv 문서 참고).

2. 2

   리포지토리를 클론합니다.

   git clone https://github.com/HKUDS/ViMax.git
3. 3

   프로젝트 디렉터리로 이동해 종속성을 설치합니다.

   cd ViMax && uv sync
4. 4

   로컬 에이전트 설정을 만들고 API 키를 추가한 다음 TUI를 시작합니다.

   cp configs/agent.example.yaml configs/agent.local.yaml

사용 전 알아둘 점

• !LLM, 이미지 및 동영상 생성 제공업체의 API 키가 필요하며, 비용이 상당히 많이 들 수 있습니다.
• !실행하기 전에 모델 및 제공업체 세부 정보가 포함된 YAML 파일을 설정해야 합니다.
• !README에는 Linux와 Windows만 지원한다고 나와 있습니다.

토픽

자주 묻는 질문

ViMax은(는) 무엇인가요?

스토리 아이디어, 각본, 소설을 대본·스토리보드·캐릭터·영상 생성 에이전트의 협업으로 여러 장면의 영상으로 만드는 에이전트형 영상 생성 프레임워크입니다. ViMax는 이야기를 완성된 영상으로 만드는 과정을 자동화하는 에이전트형 영상 제작 프레임워크입니다. 대본 작성, 스토리보드 제작, 캐릭터 및 레퍼런스 디자인, 샷 계획, 이미지와 영상 생성, 최종 편집까지 지원하므로, 사용자는 각 장면을 일일이 제작하는 대신 짧은 콘셉트나 긴 글에서 시작할 수 있습니다.

ViMax은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ViMax은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ViMax은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ViMax의 마지막 커밋은 2026년 9월 30일입니다.

ViMax은(는) 어디에 사용할 수 있나요?

글로 작성한 콘셉트로 단편 영화나 예고편을 빠르게 시안 제작합니다. 각본을 검토용 멀티샷 영상으로 변환합니다. 소설의 한 장을 에피소드 형식의 애니메이션 스타일 영상으로 각색합니다. 사용자의 사진이 등장하는 맞춤형 단편 이야기를 만듭니다.

ViMax는 어떻게 설치하나요?

uv를 설치합니다(README에 링크된 uv 문서 참고). 리포지토리를 클론합니다.: git clone https://github.com/HKUDS/ViMax.git 프로젝트 디렉터리로 이동해 종속성을 설치합니다.: cd ViMax && uv sync 로컬 에이전트 설정을 만들고 API 키를 추가한 다음 TUI를 시작합니다.: cp configs/agent.example.yaml configs/agent.local.yaml

ViMax은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/HKUDS/ViMax