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:
misyaguziya
2025-10-09 13:11:59 +09:00
parent b0fd63afbd
commit 5efa9c37d6
23 changed files with 2147 additions and 0 deletions

View 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 をブロードキャストできる。