YuE2 로컬 음악 생성 모델, 내 맥에서 돌릴 수 있을까

가사와 "잔잔한 어쿠스틱 팝, 여성 보컬" 같은 한 줄만 넣으면 보컬과 반주가 다 들어간 노래를 내 컴퓨터에서 만들어 주는 오픈소스 모델이 YuE2입니다. 9월 공개 직후 GitHub 전체 트렌딩 1위, Hugging Face 트렌딩 3위에 올랐습니다.

다만 공식 권장 사양은 NVIDIA 그래픽카드 24GB이고 맥은 아직 실험 단계입니다. 무엇이 되고 무엇이 필요한지, 그리고 제 M4 맥에서 돌릴 수 있는지 공식 문서와 직접 대조해 정리했습니다.

손글씨 가사 종이 위 카세트테이프에서 풀려 나온 테이프가 마이크를 든 가수의 옆모습으로 말려 올라간 장면

YuE와 YuE2는 무엇인가요?

가사를 노래로 바꿔 주는 오픈소스 음악 생성 모델로, 2025년 1월 YuE가 나왔고 2026년 9월 YuE2가 나왔습니다. 홍콩과기대(HKUST)와 연구 커뮤니티 M-A-P가 함께 만들었습니다.

처음 나온 YuE는 7B 크기의 1단계 모델과 1B 크기의 2단계 모델을 이어 붙인 구조였고 영어, 중국어, 광둥어, 일본어, 한국어 가사를 지원했습니다. 코드와 가중치 모두 Apache 2.0이었습니다. 지금 저장소의 기본 화면은 YuE2로 바뀌었고 원래 YuE는 YuE-v1 브랜치에 그대로 남아 있습니다.

YuE2는 노래를 바로 만들지 않고 멜로디와 코드를 적은 악보부터 계획한 뒤 그 악보대로 소리를 만듭니다. 결과는 48kHz 스테레오 오디오입니다. 연구팀이 만든 평가 세트(WildSongBench, 192개 프롬프트)에서 Suno v5, v6와 견줄 만하다고 밝혔는데, 최고 점수 사이의 작은 차이는 통계적으로 의미 있는 차이라고 단정할 수 없다는 단서도 스스로 달아 두었습니다.

가사와 스타일에서 악보 계획, 음악 토큰, 소리 잠재값을 거쳐 48kHz 완성곡이 되는 YuE2의 생성 순서와 공식 권장 사양을 정리한 그림

중간에 악보가 있어서 할 수 있는 일이 늘었습니다. 만든 노래의 멜로디를 고치거나 화성을 재즈풍으로 바꾸면서 가사 순서와 보컬 멜로디는 유지하는 식의 편집, 그리고 다른 녹음을 받아 악보로 옮긴 뒤 새 스타일로 부르는 커버 생성까지 공식 데모로 보여 줍니다.

어떤 컴퓨터가 있어야 하나요?

공식 권장은 Linux, Python 3.12, BF16을 지원하는 NVIDIA 그래픽카드 24GB입니다. README에 이렇게 적혀 있고 이 조건에서 양자화 없이 48kHz 오디오를 만든다고 설명합니다.

그 밖의 환경은 하드웨어 문서에 "실험 경로"로 따로 정리돼 있습니다. 저메모리 모드, Windows, AMD, Apple Silicon, Intel 그래픽카드가 여기에 들어갑니다. 실제 성공 사례로는 RTX 5060 노트북(8GB)에서 저메모리 옵션과 FP8을 써서 두 곡을 끝까지 만든 보고가 올라와 있습니다.

환경공식 문서의 상태
NVIDIA 24GB 이상, Linux기본 권장 환경
NVIDIA 8GB 노트북저메모리 옵션과 FP8로 두 곡 완성 보고 있음 (실험)
Intel Arc Pro 32GB58초 곡 생성 보고 있음 (실험)
Apple Silicon 맥macOS 14 이상, PyTorch 2.14.1 고정. 공식 수락은 아직 대기 중
CPU만참고용 경로. 속도와 곡 길이는 보장하지 않음

제 M4 맥에서는 돌아갈까요?

설치와 실행 경로는 있지만 공식적으로 "된다"고 확인된 환경은 아닙니다. 제 맥의 사양을 확인해 공식 문서와 나란히 놓아 봤습니다.

항목공식 권장제 맥
칩NVIDIA GPU (BF16)Apple M4
메모리그래픽카드 메모리 24GBCPU와 GPU가 함께 쓰는 통합 메모리 24GB
운영체제LinuxmacOS (macOS 14 이상이면 실험 경로 해당)
남은 디스크모델 파일은 첫 실행 때 내려받음28GB

통합 메모리 24GB는 숫자만 보면 권장 VRAM과 같지만 운영체제와 다른 앱도 같은 메모리를 나눠 씁니다. 또 하드웨어 문서는 맥에서 쓰는 방식이 "eager" 실행이라고 밝히고 있어, NVIDIA에서 쓰는 빠른 실행 경로를 쓰지 못합니다. 그래서 생성 시간이 길어질 것으로 보고 있습니다. 맥용 PyTorch 버전을 2.14.1로 고정한 이유도, 이전 버전에서 맥 GPU(MPS)의 attention 오류가 보고됐기 때문이라고 적혀 있습니다.

맥에서 시도한다면 공식 문서 기준으로 순서는 이렇습니다.

git clone https://github.com/multimodal-art-projection/YuE.git
cd YuE
uv sync                 # Apple Silicon은 추가 옵션 없이
yue2 doctor             # 환경 확인 (실제 생성 가능 여부와는 별개)
python examples/generate.py --output outputs/first-song
# 결과: outputs/first-song/audio.flac

공식 문서도 yue2 doctor의 결과는 환경 점검일 뿐이고 실제 생성은 따로 확인하라고 적어 두었습니다. 설치만 하고 끝내지 말고 짧은 곡 하나를 끝까지 만들어 보는 것이 확인 방법입니다.

설치 없이 먼저 들어 볼 방법은 없나요?

무료 웹 데모와 ComfyUI 워크플로가 있습니다. README에는 브라우저에서 바로 노래를 만들어 보는 NOIZ의 무료 데모가 안내돼 있고 ComfyUI에는 YuE2 기본 노드와 공식 텍스트-음악 워크플로가 들어갔습니다. 공식 데모 페이지에서는 악보와 함께 생성 결과, 커버 예시를 들어 볼 수 있습니다.

그래픽카드 사양이 낮다면 다른 오픈소스 모델도 후보입니다.

모델특징라이선스
YuE (v1)2025년 1월. 한국어 가사 지원. 24GB에서 30초 구간 2개 정도Apache 2.0
YuE22026년 9월. 악보 계획, 편집, 커버. 권장 24GB코드 Apache 2.0, 가중치 CC BY-NC 4.0 + 창작자 추가 허가
ACE-Step v1.52026년 1월. 19개 언어, 최대 4분Apache 2.0
DiffRhythm가사 타이밍(LRC) 기반, macOS 지원 추가Apache 2.0

만든 노래는 마음대로 써도 되나요?

개인 사용자와 크리에이터는 무료로 쓰고 결과물로 수익을 내도 되지만 회사가 상업적으로 쓰려면 따로 허가가 필요합니다. YuE2 가중치는 CC BY-NC 4.0에 창작자 추가 허가를 붙인 라이선스입니다.

  • 개인 사용자, 콘텐츠 크리에이터, 뮤지션은 무료로 쓰고 만든 음악으로 수익을 내도 수수료나 로열티를 내지 않습니다.
  • 학술 연구와 교육은 비상업 목적이면 무료입니다.
  • 회사의 상업적 사용은 가중치 상업 라이선스를 문의하라고 안내합니다.
  • 불법이거나 남을 속이는 용도는 금지이고 입력과 결과물에 대한 책임은 사용자에게 있습니다.

처음 버전인 YuE v1은 가중치까지 Apache 2.0이라 조건이 다릅니다. 어느 버전을 쓰는지에 따라 라이선스가 갈리니, 쓰기 전에 해당 버전의 라이선스 파일을 확인하는 편이 안전합니다. 실존 가수의 목소리를 흉내 내거나 남의 곡을 그대로 커버해 공개하는 일은 모델 라이선스와 별개로 저작권과 초상권 문제가 생길 수 있습니다.

요약

  • YuE2는 가사와 스타일 한 줄로 보컬과 반주가 있는 노래를 만드는 오픈소스 모델이고 먼저 악보를 계획해 편집과 커버까지 됩니다.
  • 공식 권장은 Linux와 NVIDIA 24GB이고 맥과 8GB 그래픽카드는 실험 경로입니다.
  • M4 맥(통합 메모리 24GB)은 설치 경로가 있지만 공식 수락 전이라 직접 생성해 봐야 압니다.
  • 개인과 크리에이터는 결과물 수익화가 무료이고 회사의 상업 사용은 별도 허가가 필요합니다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

2027 아이맞이지원금, 6월생과 7월생 얼마나 차이 날까

이미지
2027년 7월 1일 이후 태어나는 아이부터 출산 지원금 제도가 통째로 바뀝니다. 6월 30일에 태어난 첫째와 7월 1일에 태어난 첫째가 12세까지 받는 돈을 엑셀로 계산해 보니 1,250만 원 차이가 났습니다. 아직 국회를 통과하지 않은 정부 예산안 기준입니다. 국회는 12월 2일까지 예산안을 처리해야 합니다. 확정되면 이 글도 그 내용으로 고치겠습니다. 2027년 출산 지원금은 무엇이 바뀌나요? 지금 받는 지원금 세 가지가 두 가지로 합쳐집니다. 출산하면 국민행복카드로 받는 첫만남이용권과 0~1세에 매달 받는 부모급여는 「아이맞이지원금」이 되고 아동수당은 「아동기본수당」으로 커집니다. 지금 (2027년 6월 30일생까지) 바뀐 뒤 (2027년 7월 1일생부터) 첫만남이용권 + 부모급여 아이맞이지원금 (출생 후 1년 동안 4번 나눠 현금 지급) 아동수당 월 10만 원 아동기본수당 월 20만 원 (현금 10만 원 + 지역사랑상품권 10만 원) 없음 0~1세 가정보육 시 월 30만 원 추가 결혼한 부부에게는 혼인지원금 100만 원이 새로 생깁니다. 지금 있는 혼인 세액공제(1인 최대 50만 원)를 현금 지원으로 바꾸는 것이라, 세금을 거의 내지 않아 공제를 못 받던 부부도 받을 수 있게 됩니다. 정부안은 2027년 7월 시행에 1~6월 혼인신고 부부까지 소급하는 내용입니다. 다만 신청 방법은 아직 정해지지 않았습니다. 아이맞이지원금은 얼마를 언제 받나요? 첫째 1,000만 원, 둘째 1,200만 원, 셋째 이상 1,500만 원을 출생 후 1년 동안 석 달마다 나눠 받습니다. 첫째라면 분기마다 250만 원씩 네 번입니다. 현금으로 들어오고 쓰는 곳에 제한이 없습니다. 행정안전부가 정하는 우대지역에 살면 500만 원씩 더해져 첫째 1,500만 원, 둘째 1,700만 원, 셋째 이상 2,000만 원이 됩니다. 인구감소지역 등이 들어가는데 명단은 아직 조정 중입니다. ...
자세한 내용 보기

AI 에이전트 여러 개를 한 브랜치에서 돌리면 코드가 꼬이는 이유

이미지
Claude Code나 Codex 세션을 여러 개 열어 한 프로젝트를 나눠 맡기면, 같은 폴더와 같은 브랜치에서 일하는 한 한 세션의 수정이 경고 없이 사라집니다. 세션마다 git worktree로 작업 폴더를 따로 주면 수정이 모두 남고 겹치는 부분은 합칠 때 충돌로 드러납니다. 복잡한 작업을 빨리 끝내려고 터미널을 여러 개 띄웠다가 코드가 이상해진 적이 있다면 아래 원인 중 하나일 가능성이 큽니다. AI 세션 여러 개가 같은 코드를 건드리면 무엇이 꼬이나요? 파일, git 기록, 실행 환경 세 곳이 동시에 꼬입니다. 사람 개발자 여럿이 한 컴퓨터의 한 폴더에서 동시에 타이핑하는 것과 같은 상황입니다. 꼬이는 곳 증상 파일 덮어쓰기 세션 B가 예전에 읽어 둔 내용으로 파일을 저장해서 세션 A의 수정이 사라집니다. 고치다 만 코드 A가 함수 인자를 바꾸는 중인데 B가 테스트를 돌리면, B는 자기가 건드리지 않은 곳에서 깨진 테스트를 보고 엉뚱한 곳을 고칩니다. 서로 되돌리기 B가 A의 변경을 오류로 보고 원래대로 돌려놓습니다. A는 다시 고칩니다. git 잠금 두 세션이 동시에 git add 나 commit 을 하면 한쪽이 index.lock 오류로 멈춥니다. 실행 환경 개발 서버 포트, 로컬 DB, 테스트 캐시를 같이 써서 한쪽 실행이 다른 쪽을 방해합니다. 가장 위험한 건 첫 번째입니다. 오류 메시지가 하나도 나오지 않아서 나중에 "분명 고쳤는데 왜 그대로지?" 하고 나서야 알게 됩니다. herdr는 무엇을 해 주고 무엇은 직접 해야 하나요? herdr는 여러 에이전트를 띄우고 지켜보고 서로 지시하게 해 주는 도구이고 작업 폴더를 나누는 일은 따로 챙겨야 합니다. 공식 README는 herdr를 "the runtime your coding agents live on"이라고 소개합니다. 오픈소스(Apache-2.0)이고 ...
자세한 내용 보기

Claude Code와 티키타카하며 일하는 법, 한 세션으로 블로그를 만든 하루

이미지
복잡한 일일수록 AI 세션을 여러 개 띄우고 싶어지지만 저는 대부분 Claude Code 대화 하나에서 리서치하고 묻고 고르며 진행합니다. 이 블로그도 그렇게 만들었습니다. 설정, 도메인 연결, 글 두 편 게시까지 하루 동안 한 대화에서 끝냈습니다. 앞 글 AI 에이전트 여러 개를 한 브랜치에서 돌리면 코드가 꼬이는 이유 에서 여러 세션을 쓸 때의 함정을 정리했다면, 이번에는 한 세션으로 일하는 방식을 실제 기록으로 정리합니다. 한 세션 티키타카는 무엇이 다른가요? 리서치부터 점검까지 한 대화 안에서 하니 맥락을 다시 모을 필요가 없고 서로의 작업을 덮어쓸 일도 없습니다. AI가 앞에서 읽은 문서, 제가 고른 선택, 중간에 바꾼 규칙이 모두 같은 대화에 남아 있어서 다음 단계가 그 위에서 바로 이어집니다. Anthropic은 자사 멀티 에이전트 시스템을 설명하면서 여러 에이전트를 쓰면 일반 채팅보다 토큰을 약 15배 쓴다고 밝혔습니다. 또 맥락을 많이 공유해야 하는 일과 대부분의 코딩 작업은 나눠서 얻는 이득이 작다고 적었습니다. Claude Code 문서도 새 에이전트는 맥락을 처음부터 다시 모으느라 지금 세션에서 하는 것보다 느릴 수 있다고 설명합니다. 실제로 하루를 어떻게 보냈나요? AI가 조사하고 제안하면 제가 고르고 AI가 실행하면 제가 화면으로 확인하는 일을 계속 주고받았습니다. 그날 한 일을 순서대로 적으면 이렇습니다. 단계 그날 실제로 한 일 리서치 구글 검색 센트럴 문서 8개를 읽게 하고 블로그 글 쓰는 스킬에 구글 블로그 형식(제목 길이, 검색 설명, 이미지 크기)을 추가했습니다. 설정 블로그 제목과 설명은 후보를 받아 제가 고르고 시간대와 이미지 최적화는 AI가 바로 바꿨습니다. 도메인 CNAME 두 개를 넣었는데 Blogger가 "권한을 확인할 수 없습니다"를 두 번 띄웠습니다. DNS 조회로 레코드가 이미 보이는 걸 확인하고 몇 분 기다렸다...
자세한 내용 보기