https://github.com/ohcuy/tongtongtong-api
Apple Developer Academy @ POSTECH Cohort 2025 - C4 M12
https://github.com/ohcuy/tongtongtong-api
fastapi ml python swiftui
Last synced: about 2 months ago
JSON representation
Apple Developer Academy @ POSTECH Cohort 2025 - C4 M12
- Host: GitHub
- URL: https://github.com/ohcuy/tongtongtong-api
- Owner: ohcuy
- Created: 2025-07-20T05:52:38.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-20T07:11:27.000Z (11 months ago)
- Last Synced: 2025-07-20T09:18:45.689Z (11 months ago)
- Topics: fastapi, ml, python, swiftui
- Language: Python
- Homepage:
- Size: 46.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# tongtongtong-api
FastAPI로 구현된 오디오 기반 수박 숙성도 예측 서버입니다. 사용자의 오디오 파일을 업로드하면 특징을 추출하고, 학습된 모델을 사용해 숙성도(낮은 소리/높은 소리)를 예측합니다.
📂 폴더 구조
```
├── app/
│ ├── core/ # 설정 및 로거
│ │ ├── config.py # 환경변수(BaseSettings) 설정
│ │ └── logger.py # 로깅 설정
│ ├── services/ # 비즈니스 로직 (특성 추출, 임시 파일 저장)
│ │ └── feature.py
│ ├── api/ # HTTP 라우터
│ │ └── v1/
│ │ └── predict.py
│ └── main.py # FastAPI 앱 초기화 및 라우터 조립
├── models/ # ML 모델(.pkl) 파일
│ └── best_model.pkl
├── src/ # ML 모델 코드
│ └── data/
│ ├── feature_extractor.py
│ └── preprocessor.py
├── .env.example # 환경변수 예시
├── requirements.txt # Python 패키지 목록
└── README.md # 프로젝트 설명서
```
🚀 빠른 시작
1. 가상환경
```
python3 -m venv .venv
source .venv/bin/activate
```
2. 의존성 설치
```
pip install --upgrade pip
pip install -r requirements.txt
```
3. 환경변수 설정
```
cp .env.example .env
```
4. 서버 실행
```
uvicorn app.main:app --host $FASTAPI_HOST --port $FASTAPI_PORT --reload
```