Add documentation for modules and runtime instructions
- Created detailed documentation for the device_manager, model, model_extra, osc, overlay, overlay_image, transcription, translation, transliteration, utils, watchdog, and websocket modules. - Added a comprehensive run events payloads document outlining the payloads sent during various run events in the controller. - Included runtime instructions and dependencies for setting up the project in a Windows environment. - Introduced a mypy configuration file to manage type checking and ignore errors in specific modules temporarily.
This commit is contained in:
43
src-python/docs/runtime.md
Normal file
43
src-python/docs/runtime.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# 実行手順と依存関係
|
||||
|
||||
対象 OS: Windows を想定(device_manager は WASAPI / pycaw を使う)。
|
||||
|
||||
必須依存(概略):
|
||||
- Python 3.10+ 推奨
|
||||
- pip パッケージ:
|
||||
- torch
|
||||
- ctranslate2
|
||||
- transformers
|
||||
- requests
|
||||
- pyaudiowpatch
|
||||
- pycaw
|
||||
- speech_recognition
|
||||
- pydub
|
||||
- websockets
|
||||
- python-osc
|
||||
- tinyoscquery
|
||||
- sudachipy
|
||||
- pillow
|
||||
- flashtext
|
||||
- faster_whisper (オプション: Whisper をローカルで使う場合)
|
||||
- deepl / translators(外部翻訳を使う場合)
|
||||
|
||||
実行手順 (開発環境):
|
||||
1. 仮想環境を作成し有効化
|
||||
2. 必要パッケージをインストール
|
||||
- requirements.txt を用意する場合はそこからインストール
|
||||
3. `src-python` をワークディレクトリにして `python mainloop.py` を実行
|
||||
|
||||
注意点:
|
||||
- Whisper / CTranslate2 の重みは初回にダウンロードする必要がある。Controller の downloadCtranslate2Weight / downloadWhisperWeight エンドポイントからトリガできる。
|
||||
- OpenVR (SteamVR) を使う Overlay は SteamVR が動作している環境でのみ動作。
|
||||
- Windows 固有: device_manager が pyaudiowpatch と pycaw に依存。Linux/Mac での互換性は保証されない。
|
||||
|
||||
ログ:
|
||||
- process.log (標準動作ログ)
|
||||
- error.log (トレースバック)
|
||||
- models 用のロガーは `model.startLogger()` により PATH_LOGS 配下に日付付きファイルを作成する。
|
||||
|
||||
デバッグ:
|
||||
- `utils.printLog` と `utils.printResponse` が stdout に JSON を出すため、GUI 側はそれをパースして UI 更新を行う。
|
||||
- WebSocket を有効にすると外部クライアントに JSON をブロードキャストできる。
|
||||
Reference in New Issue
Block a user