로컬 Python 환경을 준비하지 않고 브라우저에서 바로 FunASR을 실행할 수 있습니다.
- Colab에 FunASR과 런타임 의존성을 설치합니다.
- Colab GPU가 있으면 자동으로
cuda:0을 사용하고, 없으면 CPU를 사용합니다. paraformer-zh, VAD, 문장부호 모델로 공개 샘플 오디오를 전사합니다.- 직접 업로드한 오디오 파일을 같은 모델로 전사합니다.
- transcript JSON을 저장하여 공유, 비교, issue 보고에 활용할 수 있습니다.
- 첫 실행에서는 모델 파일을 다운로드하므로 몇 분이 걸릴 수 있습니다.
- CPU runtime은 짧은 smoke test에 적합합니다. 긴 오디오에는 GPU runtime이 더 빠릅니다.
- 프로덕션 배포를 검토하려면 notebook을 먼저 실행한 뒤 deployment matrix를 확인하세요.
- OpenAI 호환 HTTP 서비스를 테스트하려면 examples/openai_api를 사용하세요.
| 증상 | 해결 방법 |
|---|---|
| Colab runtime이 끊기거나 재설정됨 | runtime에 다시 연결한 뒤 install cell을 먼저 실행하고 model cell을 다시 실행하세요. runtime이 재설정되면 설치된 Python 패키지가 유지되지 않습니다. |
| GPU를 사용할 수 없음 | Runtime > Change runtime type > GPU로 변경하세요. GPU가 배정되지 않아도 짧은 smoke test는 CPU로 실행할 수 있습니다. |
| 모델 다운로드가 느림 | 네트워크가 안정된 뒤 cell을 다시 실행하세요. 첫 실행은 모델 파일을 다운로드하며, 같은 runtime의 이후 실행은 더 빠릅니다. |
| 업로드한 오디오가 실패하거나 너무 큼 | 먼저 짧은 WAV/MP3로 확인하세요. 긴 오디오는 대표 구간을 잘라 Colab에서 테스트하는 것이 좋습니다. |
| 출력이 예상과 다름 | transcript JSON cell 출력을 저장하고 issue를 열 때 함께 첨부하세요. |
Notebook source: funasr_quickstart.ipynb.