README.md

metadata

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

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

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

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

실행 (로컬)

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 참고. 서사 원천(비트카드 MD·원고)은 이 데모 저장소에 포함하지 않는다.