Python 수동 설치 및 소스 코드 빌드
엔진 커스텀 연산자 개발, 오픈소스 기여 또는 Apple Silicon Mac에서 네이티브로 실행해야 하는 경우 본 가이드를 참조하세요.
1. 사전 요구사항
- Python: 3.10 또는 3.11
- FFmpeg: 오디오 포맷 변환 및 리샘플링 의존성 (macOS는
brew install ffmpeg, Ubuntu는apt install ffmpeg) - Git & Git LFS: 소스 코드 및 대규모 모델 가중치 다운로드용
2. 저장소 클론 및 가상환경 구성
bash
# 1. 코드 저장소 클론
git clone https://github.com/codeAndxv/OneASR.git
cd OneASR
# 2. Python 가상환경 생성 및 활성화
python3 -m venv .venv
source .venv/bin/activate
# 3. 필수 패키지 설치
pip install --upgrade pip
pip install -r requirements.txt3. 모델 가중치 다운로드
config.yaml에 활성화된 엔진에 따라 모델 가중치를 models/ 디렉터리에 배치합니다:
bash
# Faster-Whisper Medium 가중치 다운로드
git clone https://huggingface.co/Systran/faster-whisper-medium models/faster-whisper-medium
# X-ASR 스트리밍 모델
# tokens.txt, encoder-160ms.onnx, decoder-160ms.onnx, joiner-160ms.onnx 파일을 models/chunk-160ms-model/ 에 배치4. 서비스 시작
Uvicorn을 통해 FastAPI 게이트웨이를 실행합니다:
bash
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload5. 프론트엔드 웹 대시보드 개발
프론트엔드 대시보드는 Vue 3 + Vite 기반으로 구축되었습니다:
bash
cd web
npm install
npm run dev # 개발 서버 실행 (http://localhost:5173, 백엔드 :8000 자동 프록시)