Skip to main content
wandb.init()으로 W&B run을 초기화합니다. 기본적으로 W&B는 Python 프로세스당 하나의 활성 run을 지원합니다. run이 활성화된 상태에서 wandb.init()을 호출하면 W&B는 활성 run을 반환하거나 새 run을 생성하기 전에 이를 종료합니다. 동작은 환경과 reinit 설정에 따라 달라집니다. 하나의 프로세스에서 여러 활성 run을 관리하려면 하나의 프로세스에서 여러 run을 참조하세요.
W&B는 wandb.init()을 호출할 때 컨텍스트 관리자(with 블록)를 사용할 것을 권장합니다. 이렇게 하면 블록이 끝날 때 W&B가 run을 종료하고 해당 데이터를 업로드할 수 있습니다.

프로세스당 단일 run

다음 예시에서는 run을 초기화합니다:
basic.py
이 명령을 실행하면 다음과 유사한 출력이 생성됩니다.
이 예시에서 W&B는 nico entity의 awesome-project 프로젝트에 run exalted-darkness-6를 로깅합니다. W&B는 이 run에 고유 ID pgbn9y21을 부여합니다.

하나의 프로세스에서 여러 run 사용하기

하나의 Python 프로세스에서 여러 run을 관리하려면 wandb.init() 또는 wandb.Settingsreinit 매개변수를 사용합니다. 예를 들어, 다른 작업을 위한 수명이 짧은 보조 run을 생성하면서 기본 run을 활성 상태로 유지할 수 있습니다. 일반적인 사용 사례는 다음과 같습니다.
  • 기본 run을 활성 상태로 유지하면서 평가 또는 하위 작업을 위한 보조 run을 생성합니다.
  • 하나의 스크립트에서 여러 하위 실험을 실행합니다.
  • 하나의 프로세스에서 서로 다른 작업이나 기간을 별도의 run에 로깅합니다.
요구 사항단일 Python 프로세스에서 여러 run을 관리하려면 W&B Python SDK 버전 v0.19.10 이상이 필요합니다.

reinit 옵션

다른 run이 활성 상태일 때 wandb.init()를 호출하면 어떻게 동작할지 제어하려면 reinit 매개변수를 사용하세요. 다음 표에서는 사용 가능한 옵션과 일반적인 사용 사례를 비교합니다. 전체 매개변수 정의는 wandb.init() 레퍼런스 문서를 참조하세요.
W&B는 Hugging Face Trainer, Keras callback, PyTorch Lightning처럼 단일 전역 run을 가정하는 W&B Integrations에서 create_new 모드를 지원하지 않습니다. 이러한 인테그레이션을 사용하는 경우 각 하위 실험을 별도의 프로세스에서 실행해야 합니다.

reinit 구성하기

  • reinit 인수를 직접 지정해 wandb.init()을 사용합니다:
  • wandb.init()을 사용하고 wandb.Settings 객체를 settings 매개변수에 전달합니다. Settings 객체에서 reinit를 지정합니다:
  • wandb.setup()을 사용해 현재 프로세스의 모든 run에 대해 reinit 옵션을 전역으로 설정합니다. 동작을 한 번 설정해 두고, 해당 프로세스에서 이후 수행되는 모든 wandb.init() 호출에 적용하려는 경우 유용합니다.
  • 환경 변수 WANDB_REINIT에 원하는 reinit 값을 지정합니다. 환경 변수를 정의하면 reinit 옵션이 wandb.init() 호출에 적용됩니다.
다음 코드 스니펫은 wandb.init()을 호출할 때마다 새 run이 생성되도록 W&B를 설정하는 방법을 개략적으로 보여줍니다:

예제: 동시 프로세스

스크립트가 실행되는 전체 시간 동안 열린 상태를 유지하는 기본 프로세스를 만들고, 기본 프로세스를 종료하지 않은 채 주기적으로 수명이 짧은 보조 프로세스를 생성하려는 상황을 가정해 보겠습니다. 예를 들어, 이 패턴은 기본 run에서 모델을 트레이닝하는 동안 평가를 계산하거나 다른 작업을 별도의 run에서 수행하려는 경우에 유용할 수 있습니다. 이를 위해 reinit="create_new"를 사용해 여러 run을 초기화합니다. 이 예제에서는 “Run A”를 스크립트 전체에서 열린 상태로 유지되는 기본 프로세스로, “Run B1”과 “Run B2”를 평가와 같은 작업을 위한 수명이 짧은 보조 run으로 가정합니다. 전체적인 워크플로는 다음과 같습니다:
  1. wandb.init()으로 기본 프로세스 Run A를 초기화하고 트레이닝 메트릭을 로깅합니다.
  2. Run B1을 초기화하고(wandb.init() 사용) 데이터를 로깅한 다음 종료합니다.
  3. Run A에 데이터를 추가로 로깅합니다.
  4. Run B2를 초기화하고 데이터를 로깅한 다음 종료합니다.
  5. Run A에 계속 로깅합니다.
  6. 마지막으로 끝에서 Run A를 종료합니다.
다음 Python 코드 예제는 이 워크플로를 보여줍니다:
이전 예제에서 다음 핵심 사항을 확인하세요:
  1. reinit="create_new"를 사용하면 wandb.init()를 호출할 때마다 새 run이 생성됩니다.
  2. 각 run에 대한 참조를 유지하세요. wandb.runreinit="create_new"로 생성한 새 run을 자동으로 가리키지 않습니다. 새 run은 run_a, run_b1 같은 변수에 저장하고, 필요에 따라 해당 객체에서 .log() 또는 .finish()를 호출하세요.
  3. 기본 run은 계속 열어 둔 채, 하위 run은 원할 때마다 종료할 수 있습니다.
  4. run에 로깅을 마쳤다면 run.finish()로 run을 종료하세요. 이렇게 하면 모든 데이터가 업로드되고 run이 올바르게 종료됩니다.