Skip to main content
SFT, LoRA, QLoRA 기반 LLM 파인튜닝 실험 환경입니다.

문서 기준

  • 기준일: 2026-02-23
  • Python: 3.12
  • 운영체제: macOS, Ubuntu, Windows
  • 동기화 명령: uv sync

호환성 메모

unsloth은 datasets==4.3.0 에서만 안정적으로 동작합니다. datasets 4.5.0 이상에서는 재귀 오류가 발생하므로 버전을 변경하지 마세요.

파인튜닝 방법 비교

단일 RTX 3090 (24GB)에서는 7B 모델 기준 QLoRA를 권장합니다. unsloth을 사용하면 추가로 2배 속도 향상을 기대할 수 있습니다.

주요 패키지 역할

pyproject.toml

설치

1

프로젝트 생성

2

의존성 락 및 동기화

3

Jupyter 커널 등록

설치 확인

모든 OS 공통 확인:
Ubuntu x86_64 추가 확인:

기본 사용 예시

TRL의 SFTTrainer를 이용한 QLoRA 파인튜닝 기본 구조입니다.

트러블슈팅

설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: cv-research

다음 설치 단계를 이어서 진행합니다.