README.md

---
title: Carmilla Demo
emoji: 🦇
colorFrom: purple
colorTo: red
sdk: docker
app_port: 7860
pinned: false
---

# 카르밀라 — 잠들지 않는 밤 (인터랙티브 노벨 데모)

원작 고전 『카르밀라』를 온톨로지 기반으로 형식화한 인터랙티브 노벨 엔진 데모.
"책을 읽는 느낌 + 핵심 씬에서의 상호작용(카르밀라와의 자유 대화)"을 제공한다.

- **읽기**: 카드 단위로 넘기며 읽는다. 연출 컷은 자체 페이지로 등장한다.
- **선택**: 분기 지점에서 로라(플레이어)의 선택이 숨은 상태(신뢰/의심/쇠약)에 누적된다.
- **대화**: 카르밀라 카드에서 자유 채팅으로 개입하면, 대화가 수렴한 뒤 이야기로 복귀한다.
- **엔딩**: 누적된 숨은 상태에 따라 3종(처단/영원/구원)으로 갈린다.

## 실행 (로컬)

```bash
pip install -r requirements.txt
export OPENAI_API_KEY=...          # 채팅(LLM)용. 없으면 읽기만 동작
uvicorn engine.router:app --port 8777
# → http://localhost:8777
```

## Hugging Face Space (Docker)

이 저장소는 HF Spaces의 Docker SDK로 그대로 실행된다 (`app_port: 7860`).
`OPENAI_API_KEY`는 Space **Settings → Secrets**로 주입한다 (이미지에 포함하지 않는다).

> 무료 티어는 저장소가 임시라 재시작 시 진행 세션이 초기화된다 (데모 용도).

## 구조

엔진·아키텍처 상세는 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) 참고.
서사 원천(비트카드 MD·원고)은 이 데모 저장소에 포함하지 않는다.