README_HF.md

---
title: SOY NV AI
emoji: 📚
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
---

# SOY NV AI - 웹소설 작품 개발 어시스턴트

AI를 활용한 웹소설 작품 개발을 지원하는 어시스턴트입니다.

## 주요 기능

- 📝 웹소설 파일 업로드 및 분석
- 🤖 AI 기반 작품 분석 및 요약
- 🔗 캐릭터 관계 그래프 추출
- 📊 회차별 상세 분석
- 💬 AI 채팅 어시스턴트

## 사용 방법

1. **로그인/회원가입**: 처음 사용 시 계정을 생성하세요
2. **파일 업로드**: 웹소설 파일(.txt, .md)을 업로드하세요
3. **AI 분석**: Parent Chunk, Episode Analysis, Graph Extraction을 실행하세요
4. **결과 확인**: 분석 결과를 확인하고 AI와 대화하세요

## 환경 변수 설정

Settings > Repository secrets에서 다음 환경 변수를 설정하세요:

### 필수
- `SECRET_KEY`: Flask 시크릿 키 (랜덤 문자열)

### 선택사항
- `GEMINI_API_KEY`: Google Gemini API 키
- `DATABASE_URL`: 데이터베이스 URL (기본: SQLite)
- `OLLAMA_BASE_URL`: Ollama 서버 URL

## 기술 스택

- **Backend**: Flask, SQLAlchemy
- **AI**: Google Gemini, Ollama
- **Vector DB**: ChromaDB
- **Embedding**: Sentence Transformers

## 주의사항

⚠️ Hugging Face Spaces는 임시 저장소입니다. 중요한 데이터는 정기적으로 백업하세요.

## 라이선스

MIT License