snow_white_gguf

Snow White Character Model (GGUF)

백설공주 캐릭터의 페르소나를 학습한 Fine-tuning 모델입니다. 동화 속 백설공주의 성격, 말투, 배경 스토리를 반영하여 대화합니다.

모델 상세

• 모델 타입: Qwen3-4B 기반 Fine-tuning
• 형식: GGUF (Q4_0 양자화)
• 크기: 2.37 GB
• 언어: 한국어
• 용도: 대화형 캐릭터 AI, 페르소나 기반 대화

모델 설명

이 모델은 그림 형제의 동화 "백설공주"의 주인공 백설공주 캐릭터의 페르소나를 학습한 Fine-tuning 모델입니다.

특징

• 페르소나: 백설공주 캐릭터의 성격과 말투 반영
• 배경 스토리: 동화 속 백설공주의 이야기 기반
• 말투: 부드럽고 따뜻한 존댓말 사용
• 응답 스타일: 간결하고 직접적인 대화 (1-2문장)

학습 방법

• 베이스 모델: Qwen/Qwen3-4B-Instruct-2507
• Fine-tuning 기법: QLoRA (파라미터 효율 Fine-tuning)
• 학습 데이터: 동화 스토리 기반 장면 및 대화 데이터
• 학습 파라미터:
  • Epochs: 3
  • Learning Rate: 2e-4
  • Max Length: 2048

사용 방법

Ollama에서 사용

# 1. 모델 다운로드
huggingface-cli download PJiNH/snow_white_gguf model-q4_0.gguf --local-dir ./models/

# 2. Modelfile 생성
cat > Modelfile << 'EOF'
FROM model-q4_0.gguf

PARAMETER temperature 0.7
PARAMETER top_p 0.95
PARAMETER top_k 40
PARAMETER num_predict 300
PARAMETER repeat_penalty 1.1
PARAMETER repeat_last_n 64
EOF

# 3. Ollama에 모델 등록
ollama create snow_white -f Modelfile

# 4. 대화 시작
ollama run snow_white

Python에서 사용 (llama-cpp-python)

from llama_cpp import Llama

llm = Llama(
    model_path="./models/model-q4_0.gguf",
    n_ctx=2048,
    temperature=0.7,
    top_p=0.95,
    top_k=40,
    repeat_penalty=1.1,
)

response = llm(
    "안녕하세요! 당신은 누구세요?",
    max_tokens=300,
    stop=["</s>"],
    echo=False
)
print(response['choices'][0]['text'])

Open-LLM-VTuber와 통합

이 모델은 Open-LLM-VTuber 프레임워크와 통합되어 음성 대화 및 Live2D 아바타와 함께 사용할 수 있습니다.

자세한 사용 방법은 프로젝트 저장소를 참조하세요.

예시 대화

사용자: 안녕하세요!
백설공주: 안녕하세요! 오늘도 좋은 하루 되셨나요?

사용자: 당신은 누구세요?
백설공주: 저는 백설공주예요. 왕자와 함께 행복하게 살고 있어요.

사용자: 일곱 난쟁이들은 어때요?
백설공주: 난쟁이분들과 함께 있던 시간이 정말 소중했어요. 그분들 덕분에 많은 것을 배웠죠.

모델 한계

• 학습 데이터 기반의 제한된 응답 범위
• 동화 배경에 맞지 않는 현대적인 주제에 대한 응답 한계
• 다른 캐릭터로의 역할 전환 불가

라이선스

이 모델은 MIT 라이선스 하에 배포됩니다.

베이스 모델인 Qwen3는 별도의 라이선스를 가지고 있을 수 있습니다. 사용 시 베이스 모델의 라이선스를 확인하세요.

참고 자료

• 프로젝트 저장소: https://github.com/RomEscape/Fairytale_Project
• 베이스 모델: Qwen/Qwen3-4B-Instruct-2507
• Ollama: https://ollama.com/

인용

이 모델을 사용하시면 다음 형식으로 인용해주세요:

@misc{snow_white_gguf,
  title={Snow White Character Model (GGUF)},
  author={PJiNH},
  year={2025},
  url={https://huggingface.co/PJiNH/snow_white_gguf}
}