Fresh start on MariaDB Gitea

README.md

@@ -0,0 +1,49 @@
+# TTS 저장/조회/삭제 앱
+
+## 프로젝트 구조
+```
+.
+├── client
+│   ├── static
+│   └── templates
+├── server
+│   ├── db.py
+│   ├── main.py
+│   └── tts_service.py
+├── resources
+├── .env
+├── .env.example
+├── requirements.txt
+└── README.md
+```
+
+## 실행 방법
+1) 의존성 설치
+```
+pip install -r requirements.txt
+```
+
+2) 환경 변수 설정
+```
+cp .env.example .env
+```
+`.env`에 DB 계정 정보를 입력하세요.
+
+3) 서버 실행
+```
+uvicorn server.main:app --reload
+```
+
+4) 접속
+```
+http://localhost:8000
+```
+
+## 주의 사항
+- PostgreSQL 접속 정보는 프로젝트 루트의 `.env`에서 로드합니다.
+- `server/`에서 실행하더라도 루트 `.env`가 적용됩니다.
+- 배포 스크립트 기본 포트는 `8019`이며 `PORT`로 변경할 수 있습니다.
+- ffmpeg가 설치되어 있어야 합니다.
+- mp3 파일은 `resources/` 아래에 저장됩니다.
+- 고품질 TTS를 위해 `TTS_ENGINE=mms`를 설정할 수 있습니다.
+- MMS 모델(`facebook/mms-tts-kor`)은 비상업(CC-BY-NC-4.0) 라이선스입니다.