콘텐츠로 이동

로컬 개발

FastAPI 백엔드와 Vite 개발 서버를 직접 실행합니다 — 코드를 수정하기에 가장 좋습니다.

사전 준비

  • Python 3.11+
  • Node.js 20+ (CI는 Node.js 24로 검증)
  • yt-dlp
  • ffmpeg / ffprobe

백엔드

cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
CVN_DB_MIGRATE_ON_STARTUP=true uvicorn app.main:app --host 127.0.0.1 --port 8000

프런트엔드

cd frontend
npm install
VITE_API_BASE_URL=http://127.0.0.1:8000 npm run dev -- --host 127.0.0.1 --port 5173

콘솔 열기

http://127.0.0.1:5173/

헬스 체크

curl http://127.0.0.1:8000/api/health

실제 다운로드 켜기

개발 서버는 워커가 꺼진 상태로 시작합니다. 실제 전송을 하려면 워커 플래그를 설정하고 백엔드를 재시작하세요 — 실제 다운로드 켜기 참고.

다음 단계