콘텐츠로 이동

🎓 MediConSol LLM 학습 매뉴얼#

처음 LLM 파인튜닝 하시는 분을 위한 완전 가이드

이 매뉴얼은 누구를 위한 것인가?#

  • ✅ LLM(대형언어모델)을 처음 다뤄보는 분
  • ✅ 코드는 Claude Code가 도와주지만, 무엇을/왜 해야 하는지 알고 싶은 분
  • ✅ 병원 도메인(요양·전문·의원·재활·한방 등)에 AI를 적용하고 싶은 분
  • ✅ "이 버튼 누르면 어떻게 되지?"가 궁금한 분

학습 순서 (이 순서대로 읽으세요)#

🎯 Week 1: 개념 이해 (1-2일)#

  1. 01_WHAT_IS_LLM.md - LLM이 뭔가요? 왜 파인튜닝?
  2. 02_GLOSSARY.md - 꼭 알아야 할 용어 20개
  3. 03_MENTAL_MODEL.md - 머리 속에 그려야 할 그림

🚀 Week 1: 맛보기 (3-5일)#

  1. 04_FIRST_RUN.md - 처음으로 한 번 돌려보기 (⭐ 가장 중요)
  2. 05_UNDERSTANDING_OUTPUT.md - 출력 해석하기
  3. 06_TROUBLESHOOTING.md - 막힐 때 대처법

💪 Week 2-3: 실전 학습#

  1. 07_DATA_COLLECTION.md - 진짜 데이터 모으기
  2. 08_HYPERPARAMETERS.md - 하이퍼파라미터 튜닝
  3. 09_EVALUATION.md - 품질 평가 방법

📈 Week 3+: 운영#

  1. 10_OPERATIONS.md - 재학습 주기, 버전 관리, 롤백

📖 참고 자료#

🎯 학습 목표#

이 매뉴얼을 다 읽고 나면:

  • LLM/LoRA/파인튜닝이 뭔지 설명할 수 있다
  • 왜 Gemma 4와 MLX를 선택했는지 설명할 수 있다
  • 학습 데이터가 어떻게 생겼는지 안다
  • make 명령을 자신 있게 실행할 수 있다
  • 학습 중 loss 그래프를 보고 판단할 수 있다
  • 모델이 잘못된 응답을 할 때 원인을 추측할 수 있다
  • 언제 재학습해야 하는지 판단할 수 있다

⚡ 시간이 없다면 - 최소 경로#

"일단 빨리 돌려보고 싶어요" 라면:

  1. 04_FIRST_RUN.md 만 읽고 시작 (30분)
  2. 실제로 make all-mlx 돌려보기 (3-5시간 대기)
  3. 결과 보고 다시 05_UNDERSTANDING_OUTPUT.md 읽기
  4. 이해 안 되는 개념이 나오면 02_GLOSSARY.md 참조

💬 Claude Code와 함께 학습하는 법#

막히면 Claude Code에게 물어보세요. 이 매뉴얼이 기본 개념을 가르쳐주고, Claude Code가 실제 실행을 도와줍니다.

예시 질문:

"04_FIRST_RUN.md 읽었는데, make setup-mlx가 에러나. 어떻게 해결해?"

"학습 중인데 loss가 계속 올라가는데 이게 정상이야?"

"07_DATA_COLLECTION.md에 카테고리별로 균형있게 모으라는데, 지금 보유한 데이터 분포 확인하는 스크립트 만들어줘"

🏥 메디콘솔 특화 포인트#

이 매뉴얼은 일반 LLM 튜토리얼이 아니라, 메디콘솔 병원 도메인(요양·전문·의원·재활·한방 등)에 특화되어 있습니다:

  • 예시 데이터가 전부 병원 간호 기록·경영 Q&A (유형별 사례 포함)
  • PHI(환자 식별정보) 보안이 최우선
  • 맥미니 M4 24GB에서 MLX로 로컬 학습
  • Voice ENR / RNDiary / Connect 연동을 전제

일반 LLM 튜토리얼(영어 데이터, Colab, OpenAI API)과 다르므로, 혼선 없이 진행할 수 있습니다.

🎬 지금 시작하세요#

1번 문서부터 순서대로 읽으시면 됩니다.

# 매뉴얼 읽기
cd mediconsol-llm/training
open 01_WHAT_IS_LLM.md

# 또는 터미널에서
less 01_WHAT_IS_LLM.md

화이팅입니다! 🚀