Python 手動セットアップ
カスタムエンジンの演算子を開発したり、オープンソースプロジェクトに貢献したり、Apple Silicon Mac 上でネイティブ実行したい場合は、このガイドを参照してください。
1. 前提条件
- Python：3.10 または 3.11
- FFmpeg：音声フォーマットの変換とリサンプリングに必要（macOS は
brew install ffmpeg、Ubuntu はapt install ffmpegを実行） - Git & Git LFS：ソースコードおよび大規模モデルの重み（Weights）のダウンロードに使用
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. フロントエンド Web ダッシュボードの開発
フロントエンドダッシュボードは Vue 3 + Vite で構築されています：
bash
cd web
npm install
npm run dev # 開発サーバーは http://localhost:5173 で起動し、自動的に :8000 へリクエストをプロキシします