README.md

---
title: SOY NV AI
emoji: 📚
colorFrom: blue
colorTo: purple
sdk: docker
sdk_version: "4.0.0"
app_file: app.py
pinned: false
---

# 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 시크릿 키 (랜덤 문자열)

### 데이터베이스 (권장: 외부 데이터베이스 사용)
- `DATABASE_URL`: 데이터베이스 연결 URL
  - **PostgreSQL (권장)**: `postgresql://user:password@host:port/database`
    - 무료 PostgreSQL 제공 서비스: [Supabase](https://supabase.com/), [Neon](https://neon.tech/), [Railway](https://railway.app/)
  - **SQLite (기본값)**: 설정하지 않으면 자동으로 SQLite 사용 (⚠️ 데이터가 영구 저장되지 않음)
  - **MySQL**: `mysql://user:password@host:port/database`

### 선택사항
- `GEMINI_API_KEY`: Google Gemini API 키
- `OLLAMA_BASE_URL`: Ollama 서버 URL
- `HUGGINGFACE_HUB_TOKEN`: Hugging Face 토큰

## 기술 스택

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

## 주의사항

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