# 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)

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/

인용

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

bibtex

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