YILING0013/AI_NovelGenerator

AI 소설 생성기 – 개요

AI 소설 생성기는 대규모 언어 모델을 활용하여 작가가 소설을 계획하고 작성하는 것을 돕는 자체 호스팅 웹 애플리케이션입니다. Next.js 프론트엔드, FastAPI 백엔드, MongoDB 저장소를 결합합니다. 사용자는 자신의 LLM API 키(OpenAI, Gemini, Claude, DeepSeek 등)를 제공하고, 앱이 프롬프트를 구성하여 모델에 보내고 생성된 텍스트를 반환하며, 이를 편집, 저장, 버전 관리할 수 있습니다.

핵심 기능 (README 설명 기준)

영역	앱이 하는 일
소설 관리	프로젝트의 "책장"을 만들고 제목, 핵심 아이디어, 플롯, 세계관, 스타일, 시점, 분량 등을 저장합니다. 필드는 수동으로 편집하거나 AI로 채울 수 있습니다.
스노우플레이크 방식 계획	높은 수준의 스토리 코어에서 볼륨 → 아크 → 장면 → 챕터 계획 → 산문으로 작가를 안내합니다. 각 단계에는 편집 가능한 필드(목표, 비트, 캐릭터 등)가 있습니다.
챕터 편집	챕터 계획, 원고, 개정 내역, 캐릭터 심리·관계·세계 규칙 등을 확인하는 "챕터 기록"을 보여주는 통합 편집기.
엔티티 및 관계 관리	캐릭터, 세력, 장소, 아이템, 세계 규칙, 복선 단서 전용 카드와 시각적 관계 그래프.
AI 워크플로우 디자이너	각 노드가 데이터 읽기, 컨텍스트 준비, LLM 호출, 결과 병합 또는 후보 출력을 할 수 있는 노드 기반 캔버스. 내장 워크플로우는 소설 생성, 캐릭터 생성, 볼륨 계획, 장면/아크 생성, 산문 초안, 챕터 후 검사를 다룹니다. 사용자는 노드를 복사, 편집, 연결하여 사용자 정의 파이프라인을 구축할 수 있습니다.
모델 통합	OpenAI, DeepSeek, Gemini, Claude 및 호환 엔드포인트용 어댑터. 노드별로 API 키, 엔드포인트 URL, 모델 이름, 생성 매개변수를 설정합니다.
반응형 UI	데스크톱 및 모바일 지원, 라이트/다크 테마, 영어/중국어 인터페이스.

작동 방식 (높은 수준 흐름)

설정에서 모델 구성 (API 키, 엔드포인트, 모델 이름 제공).
소설 프로젝트 생성 – 간단한 아이디어와 목표 분량 입력.
내장 스노우플레이크 워크플로우 실행 – 앱이 모델에 프롬프트하여 핵심 아이디어를 전체 계획 레이어(볼륨, 아크, 장면 등)로 확장.
각 계획 수준에서 엔티티(캐릭터, 세력, 장소) 편집/확인.
챕터 계획 노드를 사용하여 챕터 산문 생성 – 모델은 계획, 관련 컨텍스트, 설정한 제약 조건을 받습니다.
원고 편집, 개정 내역 확인, 생성된 텍스트 승인.
챕터 후 검사가 자동으로 세계 규칙과 캐릭터 상태 일관성 검증.
소설이 완성될 때까지 후속 챕터에서 반복.

설치 및 실행 (요약)

전제 조건: Python 3.13/3.14, Node 20+, MongoDB 복제 세트(Docker compose 제공), DB용 Docker(선택 사항).
단계:
1. 리포지토리 클론, Python 가상 환경 설정, requirements.txt 설치.
2. cd frontend && npm ci로 UI 설치.
3. docker compose -f compose.mongodb.yaml up -d로 단일 노드 MongoDB 복제 세트 시작 및 rs.initiate(...) 실행.
4. backend/config/config_default.yaml를 config.yaml로 복사하고 MongoDB URL 입력.
5. 서비스 시작 – Windows에서는 start.bat 더블 클릭(데스크톱 런처) 또는 python main.py(백엔드) 및 npm run start(프론트엔드).
접근: UI는 http://127.0.0.1:3300, API 문서는 http://127.0.0.1:8200/docs.

사용 대상

작가: AI 지원 브레인스토밍 및 초안 작성, 모든 데이터를 로컬에 유지하려는 분.
인디 개발자 또는 취미 개발자: LLM 기반 콘텐츠 생성 파이프라인을 탐구하는 분.
연구자: 서술 창작을 위한 인간-AI 공동 창작 워크플로우를 연구하는 분.

라이선스

GNU Affero General Public License v3.0에 따라 배포됩니다.

결론

AI 소설 생성기는 스노우플레이크 방법으로 소설을 구조화하고, 캐릭터와 세계관 세부 사항을 관리하며, 구성 가능한 LLM 워크플로우를 통해 산문을 생성하거나 수정할 수 있는 풀스택, 로컬 호스팅 도구입니다. 이는 단순한 데모나 튜토리얼 모음이 아니라 AI 증강 창작 소프트웨어의 구체적인 예입니다.