ローカルアプリ処理
各ユーザーのPC上のMOJIOKOで処理します。文字起こしAPI原価が発生しないため、クラウド利用枠を消費しません。
Billing Policy
どの処理がクラウド利用枠を使うか
ローカルMCP処理
各ユーザーのPC上のHTTP MCPサーバーで処理します。MOJIOKO_MCP_FORCE_LOCAL=true でクラウド指定を無視してローカル固定にします。
クラウド処理
公開SaaSまたはクラウドAPIで処理します。サークル会員や有料プランのクラウド利用枠・従量記録の対象です。
完全ローカル運用を売る場合は、文字起こしだけでなく議事録整形LLMもローカル化または無効化してください。クラウドLLMを使う設定では、整形用テキストが外部APIへ送信されます。
Requirements
必要なPC
最低目安
- Windows 10 / 11
- NVIDIA RTX 3060 12GB相当以上
- RAM 32GB以上
- 空きストレージ100GB以上
- Python 3.12、ffmpeg、NVIDIAドライバー
推奨
- Windows 11 Pro
- NVIDIA RTX 4070 Ti SUPER 16GB以上
- RAM 64GB
- NVMe SSD 空き200GB以上
- 話者分離を使う場合は
HF_TOKEN
Install
セットアップ手順
事前確認
PowerShellまたはコマンドプロンプトでGPU、Python、ffmpegを確認します。
nvidia-smi py --version ffmpeg -version
MOJIOKOの依存関係を入れる
MOJIOKOフォルダでセットアップを実行します。
scripts\setup_internal_desktop.bat
.envをローカル固定にする
MINUTES_WHISPER_BACKEND=local_strict MINUTES_ALLOW_CLOUD_FALLBACK=false DIARIZE_MODE=local MOJIOKO_MCP_FORCE_LOCAL=true HF_TOKEN=<Hugging Face token>
診断する
必須チェックがOKなら、ローカル文字起こしはMOJIOKOのクラウド利用枠を消費しません。
powershell -ExecutionPolicy Bypass -File scripts\check_local_gpu_setup.ps1
Usage
使い方
デスクトップアプリ
セットアップ後、デスクトップの MOJIOKO.lnk を開き、音声ファイルを追加して「ローカルGPU」を選びます。
HTTP MCP
AIツールから使う場合はローカルHTTP MCPを起動し、Custom MCPへURLとBearer tokenを登録します。
scripts\run_http_server.bat curl http://127.0.0.1:8765/health
mcp_force_local: true と gpu: true が確認できれば、MCP経由の文字起こしもローカル固定です。
Custom MCP
MCP登録内容
同じPCから使う場合
URL: http://127.0.0.1:8765/mcp Auth: Bearer token Token: MOJIOKO_LOCAL_API_KEY の値
社外から固定URLで使う場合
URL: https://<customer-mcp-host>/mcp Auth: Bearer token Token: MOJIOKO_LOCAL_API_KEY の値
公開する場合はCloudflare Accessで顧客ドメインまたは指定メールだけを許可します。
Support Checklist
サポート時に見る項目
nvidia-smiでGPU名が出るかscripts\setup_internal_desktop.batが最後まで通ったか.envがlocal_strict/cloud fallback false/MOJIOKO_MCP_FORCE_LOCAL=trueかscripts\check_local_gpu_setup.ps1の必須チェックがOKか- 5分程度のサンプル音声でローカルGPU処理が完了するか
- HTTP MCP利用時は
/healthのmcp_force_localとgpuが true か
まずはクラウド版で試す
GPU PCがない場合や、すぐ試したい場合はクラウド版を使ってください。高機密会議や従量費を抑えたい運用では、ローカルGPU版を構築します。