Skip to content

Release notes

2.4.0

  • 배포 예정 (작성일: 2026/10/22)
  • SaigeToolkit 요구 버전: >=2.8.3,<2.9.0
  • [기능 추가]
    • Continuous Training: Paired/Unpaired Trainer의 pause(path, metadata=None, password=None) / resume(path, password=None) 추가.
    • Model, 모든 optimizer/scheduler, counter, training loader 소비 위치와 RNG를 저장·복원하여 새 프로세스에서 완료된 step 다음부터 학습을 이어갑니다.
    • CycleGAN의 두 image pool과 validation worker warm-up 상태를 함께 복원합니다.
    • 저장 성공 후 training worker를 종료합니다. 실패한 step의 gradient를 정리하고 optimizer 갱신 이후 실패한 경우 resume 전까지 학습을 차단합니다.
  • [Bug fix]
    • Infinite sampler의 epoch 계산과 checkpoint의 epoch_step 저장 오류 수정.
    • 새 프로세스의 validation이 추가 worker seed를 소비하던 lifecycle 차이 수정.
  • [호환성 및 지원 범위]
    • use_infinite_sampler=True에서 pause/resume를 지원합니다. Finite loader의 기존 학습은 유지하며 pause/resume는 ResumableSamplerTypeError (public code -416336)를 반환합니다.
    • Resume checkpoint는 module major/minor가 같아야 하며 patch 차이는 양방향으로 허용합니다. 호환되지 않는 version은 state schema보다 먼저 검사합니다.
    • 일반 model checkpoint 형식은 유지합니다. 같은 config, 데이터 내용·순서, transform, library version과 device 종류가 필요합니다.
    • Private RNG, CUDA transform, stateful dataset과 stochastic validation worker의 상태는 별도 관리가 필요합니다.
  • [CI/CD]
    • GitHub 전용 credential helper로 private dependency를 설치하고 Git/pip URL에서 PAT를 제거합니다.
    • 같은 PR의 이전 CI 실행을 취소하고 Linux/Windows에 source/native resume 검사를 연결합니다.
    • Windows GPU lock의 run·attempt·job 소유권을 확인하여 해제합니다. 소유 정보를 기록한 뒤 lock을 공개하고, 종료된 workflow attempt의 남은 lock은 자동 회수합니다. 조회 실패나 소유 정보 누락 시 lock을 유지합니다. CPU resume 검사와 Cython build는 lock을 획득하기 전에 수행합니다.
    • Python 변경이 없는 commit, 공백이 포함된 경로와 Python 파일 삭제도 Style check에서 처리합니다.
  • Train API 사용법

2.3.2

  • 2025/09/17
  • SaigeToolkit 버전 업데이트: 2.7.1

2.3.1

  • 2025/06/20
  • [기능 변경]
    • Padding이 과도하게 적용되는 경우 가장자리가 왜곡되는 현상을 해결하기 위해 reflection padding으로 변경하였습니다.

2.3.0

  • 2025/04/11
  • SaigeToolkit 버전 업데이트: 2.6.2
  • [버전 업데이트]
    • SaigeToolkit 버전 업데이트에 따라 torch 2.7+cu128로 업데이트 되었습니다.

2.2.2

  • 2025/03/24
  • SaigeToolkit 버전 업데이트: 2.5.1
  • [기능 개선]
    • AnalysisHandler를 통한 analyze()에 동시성 프로그래밍 적용.

2.2.1

  • 2025/02/04
  • SaigeToolkit 버전 업데이트: 2.4.0
  • [문서 수정]
    • Python 버전을 3.11.9로 명시
  • Augmentation 3종(gauss_noise, advanced_blur, elastic_transform)을 SaigeToolkit에서 로드하도록 수정

2.2.0

  • 2024/12/19
  • SaigeToolkit 버전 업데이트: 2.3.1
  • [문서 수정]
    • SaigeToolkit 의 설치 방법이 바뀌었음.
      • pip install version constraints
  • [기능 추가]
    • MemorySafeDataLoader
      • 1 이상의 num_worker를 설정하여 sub-process가 생성될 때, cpu memory가 부족한 등의 문제가 발생할 경우, error message 출력하는 기능.
      • CpuLowMemoryError, DataLoaderWorkerInitializationError

2.1.3

  • 2024/12/16
    • API Docs 및 기능에서 누락된 augmentation 3종 복원 (gauss_noise, advanced_blur, elastic_transform)

2.1.2

  • 2024/11/07
    • docstring 일부 잘못 표기된 부분 수정
      • device 세팅에서 torch.device 타입이 누락된 부분 수정

2.1.1

  • 2024/10/11
  • SaigeToolkit 버전 업데이트: 2.2.5
    • revert traceback encryption
    • segment label이 이미지를 벗어나는 케이스 에러 코드 추가

2.1.0

  • 2024/09/26
  • SaigeToolkit 버전 업데이트: 2.2.3
  • [minor 버전 정식 배포]
    • 2.1.0

2.1.0-rc3

  • 2024/09/10
  • SaigeToolkit 버전 업데이트: 2.2.2
  • [버전 업데이트]
    • SaigeToolkit 버전 업데이트에 따라 python 3.11 과 torch 2.3으로 업데이트 되었습니다.

2.1.0-rc2

  • 2024/08/26
  • [기능 추가]
    • GPU를 활용하는 전처리 시 큰 크기의 이미지로 인해 발생하는 OOM을 방지하기 위해 inspection_size(2048 x 2048)를 인자로 추가하였습니다.

2.1.0-rc1

  • 2024/08/16
  • SaigeToolkit 버전 업데이트: 2.1.0
  • [기능 변경]
    • error message를 api output에서 직접 출력하도록 수정했습니다.
      • error_code, error_message, result = api()

2.0.12

  • 2024/07/12
  • SaigeToolkit 버전 업데이트: 2a00ae
  • [기능 추가]
    • image is truncated. 에러에 대한 에러코드 추가.

2.0.11

  • 2024/05/27
  • SaigeToolkit 버전 업데이트: 09cefc
  • [기능 추가]
    • 학습 중 loss 값이 NaN인 경우 NanLossError 레이즈

2.0.10

2.0.9

  • 2024/03/12
  • [Bug Fix]
    • 2.0.7버전에서 적용되었던 버그 수정이 unpaired model에서는 적용되지 않고 있었던 문제를 해결하였습니다.

2.0.8

  • 2024/01/29
  • SaigeToolkit 버전 업데이트: 58954162
  • [기능 추가]
    • setup시 pretrained weight를 다운로드 하지 않고, build 폴더로 저장하지 않는 --without-pretrained-model 옵션 추가.

2.0.7

  • 2024/01/24
  • [Bug Fix]
    • 이미지 크기보다 큰 crop size가 지정되는 경우 발생하는 에러를 해결하였습니다.

2.0.6

  • 2024/01/11
  • SaigeToolkit 버전 업데이트: 70262443
  • [Bug Fix]
    • 매우 큰 이미지를 사용할 경우 발생하는 에러를 해결하였습니다.
  • [기능 변경]
    • checkpoint의 metadata영역이 1MB -> 12MB로 확장되었습니다.

2.0.5

  • 2023/12/27
  • SaigeToolkit 버전 업데이트: 12b57553

2.0.4

  • 2023/12/22
  • [버그 수정]
    • [PreProcessor] PreProcessor에서 denoise_level이 0일 때 발생하는 버그를 수정했습니다.
    • requirements에서 matplotlib library를 제거했습니다.

2.0.3

  • 2023/12/12
  • [버그 수정]
    • [PreProcessor] PreProcessor API의 preprocess 함수에 mask=None을 입력했을 때 발생하는 버그를 수정했습니다.

2.0.2

  • 2023/11/23
  • [기능 변경]
    • [Inference Handler] InferenceHandler의 oversized_image_handling 옵션 중 do_not_inspect가 do_not_enhance로 이름이 변경되었습니다.
    • [Inference Handler] InferenceHandler의 analyze가 더이상 intermeditate results를 저장하지 않습니다.

2.0.1

  • 2023/11/17
  • [기능 추가]

2.0.0

  • 2023/11/01
  • initial release
  • [기능 추가]
  • [추가 예정]
    • Inference Handler에 Analysis 기능을 추가할 예정입니다.
    • Preprocessing에 사용되는 ImageEnhancer API를 추가할 예정입니다.