NVIDIA BioNeMo 시작하기: NGC API Key 발급부터 컨테이너 실행까지

안녕하세요! 오늘은 바이오 컴퓨팅과 AI 신약 개발의 핵심 도구인 NVIDIA BioNeMo를 내 PC나 서버에 설치하고 실행하는 방법을 알아보겠습니다. 복잡해 보이지만, 차근차근 따라오시면 5분 안에 환경 구축을 끝낼 수 있습니다.

1. BioNeMo와 NGC, 어떻게 이해하면 좋을까?

처음 접하는 분들을 위해 비유를 들어 설명해 드릴게요.

NVIDIA BioNeMo는 마치 '최첨단 요리 도구가 가득한 이동식 주방'과 같습니다. 그리고 이 주방을 빌려올 수 있는 거대한 창고가 바로 NGC(NVIDIA GPU Cloud)입니다.

• BioNeMo 컨테이너: 요리 도구와 재료가 모두 세팅된 주방 박스.
• NGC 계정: 창고에 들어가기 위한 출입증.
• API Key: 창고 문을 열 때 입력하는 비밀번호.

우리는 오늘 이 비밀번호(API Key)를 발급받아 주방(BioNeMo)을 통째로 가져오는 작업을 할 것입니다.

2. 단계별 가이드: NGC API Key 발급하기

BioNeMo 컨테이너는 보안이 철저한 NGC 레지스트리에 보관되어 있어, 이를 pull(다운로드) 하려면 반드시 인증 키가 필요합니다.

Step 1. NGC 무료 계정 생성 및 로그인

먼저 NVIDIA NGC 홈페이지에 접속하여 계정을 만듭니다. 이미 계정이 있다면 로그인을 진행해 주세요.

Step 2. API Key 생성 메뉴 접속

로그인 후 오른쪽 상단에 있는 본인의 User(사용자 아이콘)를 클릭합니다. 드롭다운 메뉴에서 [Setup]을 선택해 주세요.

Step 3. Generate API Key 실행

Setup 페이지 중앙에 보이는 [Generate API Key] 버튼을 누릅니다. 그다음 화면에서도 한 번 더 확인 버튼을 클릭하면 고유한 API Key가 화면에 나타납니다.

주의사항: 이 API Key는 단 한 번만 보여집니다! 안전한 곳(메모장 등)에 반드시 복사해서 저장해 두세요. 유출되면 다른 사람이 내 GPU 리소스를 사용할 수 있으니 주의가 필요합니다.

3. 터미널에서 BioNeMo 컨테이너 실행하기

이제 열쇠를 얻었으니, 실제로 컨테이너를 실행해 볼 차례입니다. 터미널(또는 CMD)을 열고 아래 과정을 진행하세요.

1) NGC 로그인 인증

아래 명령어를 입력한 뒤, 패스워드 입력란에 방금 복사한 API Key를 붙여넣으세요. (Username은 항상 $oauthtoken으로 입력해야 합니다.)

docker login nvcr.io
Username: $oauthtoken
Password: <여기에_복사한_API_Key_입력>

2) BioNeMo 컨테이너 Pull 및 Run

로그인에 성공했다면, 이제 원하는 BioNeMo 모델 컨테이너를 실행할 수 있습니다. 예시는 다음과 같습니다.

# 예시: BioNeMo Framework 컨테이너 실행
docker pull nvcr.io/nvidia/clara/bionemo-framework:latest
docker run --gpus all -it --rm nvcr.io/nvidia/clara/bionemo-framework:latest

마치며

오늘 과정을 통해 NVIDIA BioNeMo를 활용할 준비를 모두 마쳤습니다. 이제 이 강력한 AI 도구를 활용해 단백질 구조 예측이나 분자 생성 같은 놀라운 연구를 시작해 보세요!

설치 과정에서 막히는 부분이 있다면 댓글로 남겨주세요. 제가 직접 도와드리겠습니다.