Houdini husk 커맨드 라인 렌더링: 프레임 범위, 타일, GPU 4장
husk는 USD Render ROP와 TOPs USD Render 노드 뒤에서 실제로 렌더링하는 프로그램입니다. 플래그만 알면 Houdini를 열지 않고도 Karma XPU 작업을 실행하고, 나누고, 이어서 렌더링할 수 있습니다:
- 범위: -f 시작, -n 개수, -i 간격, 또는 --frame-list
- 재개: 크래시 후 --skip-existing-frames
- GPU: 프로세스 하나가 모든 GPU를 사용하며, 메모리는 합쳐지지 않습니다
- 분할: CUDA_VISIBLE_DEVICES로 GPU마다 husk 하나, 또는 큰 스틸 한 장은 타일로
- 라이선스: Karma로 렌더하는 husk는 Karma 라이선스를, Python 콜백은 Engine 라이선스를 사용합니다
USD Render ROP에서 Render를 누르면 Houdini는 LOP 네트워크를 임시 USD 파일로 기록한 뒤 외부 프로세스인 husk를 실행해 렌더링합니다. 배치 작업, TOPs, 대부분의 렌더팜 제출 도구도 같은 도구를 씁니다. husk를 직접 실행하면 어떤 프레임을, 어떤 순서로, 어느 GPU에서 렌더할지, 크래시 후에는 어떻게 할지 모두 직접 제어할 수 있습니다.
이 가이드는 렌더팜 작업에 실제로 필요한 husk 플래그, GPU 4장 서버를 쓰는 두 가지 방법, 큰 스틸을 위한 타일 렌더링, 로그 읽는 법을 다룹니다. 모든 내용은 Houdini 22 문서로 확인했습니다.
SideFX Houdini 22 문서(husk, Inside husk, Karma XPU, USD Render ROP) 기준, 2026년 11월 확인.
husk란 무엇이고, 왜 모든 Houdini 렌더팜이 husk를 쓰는가
SideFX는 husk를 전체 렌더링 작업을 처리하고 제어하는, 델리게이트에 종속되지 않는 커맨드 라인 도구로 설명합니다. husk는 USD 파일을 불러와 Hydra 렌더 델리게이트(기본은 Karma, Redshift 등 다른 델리게이트도 연결 가능)를 고르고, USD 렌더 설정에 정의된 렌더 프로덕트를 기록합니다.
USD Render ROP는 husk를 감싼 얇은 래퍼입니다. ROP가 LOP 네트워크에서 만든 USD를 임시 파일로 기록한 뒤, husk를 실행해 이미지나 이미지 시퀀스를 렌더합니다. TOPs USD Render 노드도 작업 항목마다 같은 일을 합니다. 그래서 터미널에서 되는 명령은 렌더팜에서도 됩니다.
라이선스 계획도 간단합니다. SideFX에 따르면 husk 자체는 Houdini 라이선스가 있는지만 확인하고, Karma 델리게이트(CPU 또는 XPU)로 렌더하면 Karma 라이선스를, husk로 Python 콜백을 실행하면 스크립트가 도는 동안 Engine 라이선스를 사용합니다. SideFX는 라이선스를 애플리케이션이 아니라 머신 단위로 계산합니다. 전체 목록은 렌더팜용 Houdini 라이선스를 참고하세요.
출처: Inside husk, USD Render ROP, SideFX FAQ: husk 라이선스, 라이선스 시스템.
도식의 이 분리 덕분에 husk가 렌더팜에서 유용합니다. USD 파일이 기록되고 나면 렌더에는 대화형 Houdini 세션이 아니라 husk, 델리게이트, 오른쪽의 라이선스만 있으면 됩니다.
프레임 범위 작업에 필요한 husk 플래그
한 머신에서 도는 Karma XPU 시퀀스에는 보통 시작 프레임, 프레임 수, 출력 경로, USD 파일만 있으면 됩니다. 표에 알아 둘 만한 플래그를 정리했고, 표 아래 명령은 그대로 쓸 수 있는 완전한 작업입니다.
렌더팜 작업이 실제로 쓰는 husk 옵션
아래 플래그는 모두 Houdini 22 husk 페이지에 나와 있습니다.
| 플래그 | 역할 | 필요한 경우 |
|---|---|---|
| -f / -n / -i | 시작 프레임, 프레임 수(시작 프레임 포함), 프레임 간격 | 모든 시퀀스 작업. -i를 쓰면 여러 프로세스가 한 범위를 나눠 맡습니다 |
| --frame-list | 공백으로 구분한 프레임 목록. -f, -n, -i보다 우선합니다 | 잘못된 프레임 몇 개를 다시 렌더할 때 |
| -o / --make-output-path | 출력 경로, 없는 폴더 자동 생성 | 새 머신의 비어 있는 출력 폴더 |
| --skip-existing-frames | 렌더 프로덕트가 이미 디스크에 있는 프레임은 건너뜁니다 | 크래시나 재부팅 후 작업을 다시 시작할 때 |
| --engine xpu|cpu | Karma 엔진을 덮어씁니다 | USD가 CPU로 되어 있어도 XPU를 강제할 때 |
| -s / -c / -r / -p | 렌더 설정 프림, 카메라, 해상도, 픽셀 샘플 | USD 파일에 저장된 값을 덮어쓸 때 |
| -V level | 출력 상세도 0–9. e를 붙이면 경과 시간, t는 타임스탬프, a는 Alfred 형식 진행률 | 다음 날 아침에 읽을 수 있는 로그 |
| --timelimit / --snapshot | N초 후 취소, N초마다 중간 이미지 저장 | 미리보기와 지켜봐야 하는 긴 프레임 |
렌더팜에서 가장 많은 시간을 아껴 주는 플래그는 두 가지입니다. --skip-existing-frames 는 모든 렌더 프로덕트 파일이 이미 있는 프레임을 건너뜁니다. 그래서 크래시 후 같은 명령을 다시 실행하면 빠진 프레임만 렌더됩니다. --make-output-path 는 출력 폴더를 만들어 줍니다. 새 렌더 머신에는 이 폴더가 없는 경우가 많습니다.
-V 2e 는 기본 상세도를 유지하면서 로그 줄마다 경과 시간을 붙입니다. 나중에 프레임 시간을 비교하는 가장 빠른 방법입니다. 공백이 있는 경로는 따옴표로 감싸세요.
출처: husk, Houdini 22 새 기능: Karma.
GPU 4장 서버 쓰기: husk 프로세스 하나 또는 넷
Karma XPU는 감지할 수 있는 호환 장치를 여러 GPU까지 모두 사용하며, 메모리가 합쳐지지 않으므로 GPU마다 씬 사본을 따로 가집니다. 따라서 husk 프로세스 하나가 각 프레임을 GPU 4장으로 함께 렌더합니다. 가장 간단한 구성이고, 기본으로 쓰기에 맞는 방법입니다.
다른 방법은 husk 프로세스 4개를 띄워 각각 GPU 하나만 쓰고 네 번째 프레임마다 렌더하게 하는 것입니다. 도식에 장단점을 정리했습니다.
방법 A는 시스템 RAM에 USD 스테이지 사본 하나만 두고 프레임을 차례로 끝냅니다. 방법 B는 프레임 4개를 동시에 렌더하지만 스테이지를 네 번 로드하므로 씬 데이터에 RAM이 대략 4배 필요하고, 프로세스마다 로그가 따로 나옵니다. 어느 쪽이 시퀀스를 더 빨리 끝낼지는 씬에 따라 다르므로, 정하기 전에 몇 프레임으로 두 방법을 모두 테스트하고 로그의 경과 시간을 비교하세요. 속도 향상 수치는 씬마다 달라서 여기서는 싣지 않습니다.
프로세스마다 GPU를 하나로 제한하기
husk에는 GPU를 고르는 플래그가 없습니다. 대신 Karma XPU는 환경 변수를 읽습니다: KARMA_XPU_DISABLE_OPTIX_DEVICE, KARMA_XPU_DISABLE_EMBREE_DEVICE 와 KARMA_XPU_DEVICES는 쉼표로 구분한 장치 ID 목록을 받습니다. 표준 CUDA 변수 CUDA_VISIBLE_DEVICES 는 프로세스가 볼 수 있는 NVIDIA GPU를 제한합니다. 아래 배치 파일은 이 변수를 쓰고, 프로세스 4개가 CPU 코어까지 두고 경쟁하지 않도록 Embree CPU 장치를 끕니다.
Embree 장치를 끄면 부작용이 하나 있습니다. XPU는 원래 한 장치가 실패하면 CPU와 다른 GPU가 프레임을 마저 끝내게 하는데, GPU 하나에 CPU 장치도 없으면 실패가 느려지는 대신 그 프레임을 멈춥니다. 각 로그 시작 부분의 장치 목록을 보고 모든 프로세스가 OptiX 장치를 정확히 하나씩 보는지 확인하세요. GPU가 빠지는 경우 Karma XPU 멀티 GPU 초기화 실패 가이드에서 흔한 원인을 다룹니다.
출처: Karma XPU, NVIDIA CUDA 환경 변수.
큰 스틸: 타일로 렌더하고 이어 붙이기
아주 큰 프레임 한 장은 husk가 이미지를 타일로 나눌 수 있습니다. --tile-count 4 3 는 이미지를 4 x 3 격자로 나누고 --tile-index 는 렌더할 타일을 0부터 고릅니다. 타일마다 다른 머신이나 다른 GPU로 보낼 수 있습니다.
SideFX는 타일을 합치는 itilestitch 와 커맨드 라인에서 디노이즈하는 idenoise 를 함께 제공하며, 둘 다 Houdini의 bin 폴더에 있습니다. 타일별 디노이즈는 이음매가 보일 수 있으므로 타일이 아니라 이어 붙인 이미지를 디노이즈하세요. 한 머신에서는 --autotile 가 분할과 이어 붙이기를 대신해 줍니다. husk가 USD 파일을 한 번만 로드하고 렌더 후 타일을 이어 붙입니다.
타일링은 메모리에도 도움이 됩니다. Karma는 렌더 변수(AOV 버퍼)를 VRAM과 RAM에 할당하며, SideFX는 AOV가 15개인 씬이 프레임 버퍼에만 최소 1.5 GB가 필요하다고 설명합니다. Karma XPU에는 버킷 모드가 없으므로 딥 출력에는 타일링이 필요합니다.
출처: Inside husk, husk.
로그, 스냅샷, 시간 제한
오래 걸리는 프레임은 husk가 다른 머신에서도 확인할 수 있는 진행 상황을 기록하면 관리하기 쉽습니다:
- 상세도:
-V는 0–9를 받고,e는 경과 시간,t는 타임스탬프,a는 많은 큐 관리자가 읽는 Alfred 형식 진행률을 더합니다. - 스냅샷:
--snapshot 300은 300초마다 중간 이미지를 저장해 프레임이 끝나기 전에 확인할 수 있게 합니다. Linux에서는 프로세스에 SIGUSR1을 보내면 그 자리에서 한 장을 기록합니다. - 시간 제한:
--timelimit은 N초 후 렌더를 취소하고,--timelimit-image는 시퀀스 전체가 아니라 이미지마다 제한을 적용합니다. - Houdini 22 신규:
--karma-percent-of-samples는 샘플의 일정 비율에서 Karma 렌더를 멈추고,--enable-usd-errors는 평소 숨겨진 USD 경고를 보여 주며,--error-summary는 오류 보고용으로 추가되었습니다.
전체 범위를 큐에 넣기 전에 작업이 쓸 명령 그대로 한 프레임을 렌더해 대화형 렌더와 비교하세요. 나머지 점검 항목은 Karma XPU 사전 점검 체크리스트에 있습니다.
출처: husk, Houdini 22 새 기능: Karma.
husk 작업에는 SaaS와 IaaS 중 어떤 렌더팜이 맞을까?
husk 워크플로에 맞는 렌더팜 유형
둘 다 husk로 USD를 렌더할 수 있으며, 명령을 누가 작성하고 실행하는지가 다릅니다.
| 상황 | 대체로 더 맞는 쪽 | 이유 |
|---|---|---|
| .hip 또는 .usd를 제출하고 프레임만 받고 싶을 때 | SaaS(관리형 렌더팜) | 렌더팜이 husk 명령과 큐를 대신 구성합니다 |
| 플래그, GPU 분할, 타일을 직접 정하고 싶을 때 | IaaS(원격 워크스테이션) | 머신의 터미널에서 husk를 실행하고 언제든 명령을 바꿀 수 있습니다 |
| 특정 Houdini 빌드나 서드파티 델리게이트가 필요한 씬 | IaaS | 테스트한 버전 그대로 설치합니다 |
| 프로세스 하나와 GPU별 프로세스를 비교하고 싶을 때 | IaaS | 같은 서버에서 두 테스트를 모두 실행하고 로그를 읽을 수 있습니다 |
| 표준 설정의 짧은 일회성 시퀀스 | SaaS | 설정이 필요 없고 작업 단위로 비용을 냅니다 |
간단한 기준: 기본 ROP 설정으로 충분하다면 관리형 렌더팜이 가장 손이 덜 갑니다. 직접 정한 husk 플래그, 환경 변수, GPU별 분할에 의존한다면 직접 제어하는 머신에서 테스트한 명령을 그대로 실행할 수 있습니다.
iRender 서버에서 husk 작업 실행하기
iRender에서는 Windows 워크스테이션 전체를 임대해 원하는 Houdini 빌드를 설치하고 여러분의 SideFX 라이선스로 로그인한 뒤, 내 책상에서와 똑같이 husk를 실행합니다:
- USD 파일, 텍스처, 캐시가 포함된 프로젝트를 상대 경로를 유지한 채 iRender Drive로 업로드합니다.
- Karma XPU에 권장하는 4x RTX 5090 서버(카드당 32 GB)를 시작합니다. 8x 서버에서도 Karma XPU는 렌더되지만, 그에 비례해 빨라지지는 않습니다.
- 사용하는 Houdini와 드라이버 버전을 설치합니다. Karma XPU 커널은 첫 렌더에서 컴파일되며, Render 메뉴에서 미리 컴파일할 수도 있습니다(전체 세트는 몇 시간이 걸릴 수 있고, 캐시는 저장된 서버 이미지에 남습니다).
- husk 명령으로 한 프레임을 렌더하고 로그의 장치 목록과 경과 시간을 확인합니다.
- 프로세스 하나 또는 GPU별 프로세스로 전체 범위를 시작합니다.
--skip-existing-frames를 붙이면 재시작 시 멈춘 지점부터 이어서 렌더합니다.
husk 작업 체크리스트
어느 머신에서든 전체 범위를 시작하기 전에 마지막 점검용으로 쓰세요.
자주 묻는 질문
1. husk에 Houdini 라이선스가 필요한가요?
SideFX에 따르면 husk는 Houdini 라이선스가 있는지만 확인합니다. Karma CPU 또는 XPU로 렌더하면 Karma 라이선스를 사용하고, husk가 실행하는 Python 콜백은 실행되는 동안 Engine 라이선스를 사용합니다.
2. husk가 사용할 GPU를 고를 수 있나요?
husk에는 GPU 플래그가 없습니다. 각 프로세스를 시작하기 전에 KARMA_XPU_DEVICES 같은 Karma XPU 환경 변수나 CUDA 변수 CUDA_VISIBLE_DEVICES를 사용하세요.
3. Karma XPU에서 여러 GPU의 메모리가 합쳐지나요?
아니요. SideFX는 각 GPU를 따로 다루며 메모리가 합쳐지지 않는다고 밝히므로, 모든 카드가 씬을 담을 수 있어야 합니다.
4. 크래시 후 시퀀스를 어떻게 이어서 렌더하나요?
같은 명령에 –skip-existing-frames를 붙여 실행하세요. husk는 모든 렌더 프로덕트 파일이 이미 디스크에 있는 프레임을 건너뜁니다.
5. GPU마다 husk 프로세스 하나가 모든 GPU를 쓰는 프로세스 하나보다 빠른가요?
씬에 따라 다릅니다. 프로세스 4개는 프레임 4개를 동시에 렌더하지만 스테이지를 네 번 로드합니다. 몇 프레임으로 둘 다 테스트하고 로그의 경과 시간을 비교하세요.
6. 아주 큰 스틸을 여러 머신에서 어떻게 렌더하나요?
–tile-count와 –tile-index로 타일을 따로 렌더하고, itilestitch로 이어 붙인 뒤 이어 붙인 이미지를 idenoise로 디노이즈하세요.
7. husk로 프레임 범위의 일부만 렌더할 수 있나요?
네. 시작 프레임은 -f, 프레임 수는 -n으로 지정하거나, –frame-list로 프레임 목록을 정확히 지정하세요.
8. 오래 걸리는 husk 프레임을 끝나기 전에 어떻게 확인하나요?
–snapshot에 초 단위 숫자를 붙이면 husk가 그 간격으로 중간 이미지를 저장합니다. Linux에서는 프로세스에 SIGUSR1을 보내면 그 자리에서 한 장을 기록합니다.
9. Karma 프레임을 정해진 품질에서 일찍 멈출 수 있나요?
Houdini 22에서는 –karma-percent-of-samples가 샘플의 일정 비율에서 Karma 렌더를 멈춥니다.
iRender에서 Houdini Karma XPU 씬 렌더링하기
iRender는 IaaS GPU 렌더팜입니다. NVIDIA RTX 5090(32 GB) GPU 4장과 AMD Ryzen™ Threadripper™ PRO CPU, 256 GB ECC RAM, 2 TB NVMe SSD를 갖춘 베어메탈 서버를 임대해 원격 데스크톱으로 접속하고, 전체 관리자 권한으로 내 워크스테이션처럼 작업합니다. Houdini는 직접 설치하고 여러분의 SideFX 라이선스를 사용합니다. 서버 이미지가 세션 사이에 저장되므로 Houdini, 패키지, Karma XPU 커널 캐시가 그대로 남아 있습니다. Karma XPU에는 GPU 4장 서버를 권장합니다.
멀티 GPU 서버는 분 단위로 과금되며(1 GPU 서버는 최소 1시간), 3시간 이상 세션은 10% 할인됩니다. 4 GPU 서버는 수랭식이며, 자체 측정 결과 장시간 렌더링 중에도 GPU 온도가 60–70°C로 유지됩니다. 엘리트 지원팀이 주 7일 핫라인, 라이브 채팅, Skype, WhatsApp, 이메일로 도와드립니다.
이 영상은 iRender 서버에서 Houdini Karma XPU 씬을 다섯 단계로 렌더링하는 과정을 보여줍니다:
신규 사용자는 첫 충전 시 100% 보너스(최소 $50)를 받습니다. 서버 옵션은 Karma XPU 렌더팜 페이지에서 확인하거나 iRender GPU 앱.
내 머신에서 Karma XPU 렌더링이 느리다면, iRender의 Karma XPU 렌더팜는 Houdini를 직접 설치하고 여러분의 라이선스로 여러 장의 RTX 5090 GPU에서 렌더링하는 전용 원격 서버를 제공합니다 (Karma XPU에는 보통 GPU 4장 구성이 가장 효율적입니다).


