---
license: apache-2.0
language:
- ko
tags:
- visual-novel
- philosophy
- nietzsche
- electron
- gemma
- on-device-llm
- llama-cpp
---

# 차라투스트라와의 동행

니체의 『차라투스트라는 이렇게 말했다』 — 인터랙티브 비주얼 노벨로 다시 만난다.

[GitHub 소스 리포지토리](https://github.com/HwangChulHee/nietzche-sllm-project)

---

## 작품 소개

세 모드를 자유롭게 오가며 작품을 따라간다.

- **나레이션 모드** — 소설 서사 + 일러스트로 진행
- **해설 모드** — 비유와 상징의 의미를 풀어줌
- **인터랙션 모드** — 차라투스트라와 직접 대화

모든 LLM 추론은 *온디바이스*에서 동작한다. 외부 서버 통신 없이 사용자 PC가 직접 처리.

---

## 설치 및 실행

### 1. 다운로드

[Zarathustra-Setup-0.1.0.zip](https://huggingface.co/banzack/zarathustra-vn-build/resolve/main/Zarathustra-Setup-0.1.0.zip) — 3.56 GB

### 2. 압축 해제

ZIP을 원하는 폴더에 푼다. (압축 해제 후 ~3.8 GB)

### 3. 실행

풀린 폴더 안 `차라투스트라와의 동행.exe` 더블클릭.

> **Windows SmartScreen 경고**가 뜨면:
> *"추가 정보"* → *"실행"*
>
> 서명되지 않은 실행 파일이라 처음 한 번 뜸. 학부 캡스톤 프로젝트의 한계.

### 4. 첫 실행

모델 로드에 약 30초~1분 소요. *"준비 중..."* 안내 후 타이틀 화면이 뜬다.

---

## 시스템 요구사항

| 항목 | 최소 | 권장 |
|---|---|---|
| OS | Windows 10 x64 | Windows 11 x64 |
| RAM | 6 GB | 8 GB+ |
| 디스크 | 4 GB | 4 GB |
| CPU | AVX2 지원 (2013년 이후 Intel/AMD) | 4코어+ |

별도 Node.js / Python / Git 등 의존성 불필요. 모든 게 ZIP에 박혀있다.

---

## 기술 스택

- **Electron 33** — 데스크톱 앱 셸
- **Next.js 16** — 비주얼 노벨 UI
- **Express + SSE** — 백엔드 (스트리밍 응답)
- **llama.cpp** (b9159) — 온디바이스 LLM 추론
- **Gemma 4 E2B** (Q4_K_M 양자화, ~3.1 GB) — 대화 및 해설 생성
- **BGE-M3** (Q4_K_M 양자화, ~0.4 GB) — 임베딩
- **SQLite + sqlite-vec** — RAG 인덱스 (저서 청크 임베딩)

---

## 라이선스

- **Gemma 4** — Apache 2.0 (Google)
- **BGE-M3** — MIT (BAAI)
- **llama.cpp** — MIT (ggml-org)
- **자체 작품 코드** — 소스 리포지토리 참조

---

## 저자

황철희 — 숭실대학교 AI소프트웨어학부

2026년 1학기 고급캡스톤디자인

[GitHub 소스 리포지토리 →](https://github.com/HwangChulHee/nietzche-sllm-project)