このプロジェクトについて

Boloは、macOS上で動作するプッシュ・トゥ・トーク辞書アプリで、Slack、Notion、Gmail、VS Code、ターミナル、ブラウザなど、あらゆるアクティブなテキストフィールドに文字起こし結果を貼り付けることができます。名前はヒンディー語で「話す」を意味する「bolo」に由来します。macOS 12+とRust 1.88+を対象とし、MITライセンスでリリースされています。プロジェクトのウェブサイトはREADMEに記載されています。 セットアップと権限:install.shは、~/.bolo/venvにプライベートなPythonヘルパー環境を作成し、Rustバイナリをビルドします。既存のTelnyx APIキーを~/.codex/.envや環境変数から探し、見つからない場合はプロンプトを表示して~/.bolo/envに保存します。その後、Boloをログインアイテムとして登録し、起動します。初回起動時には、どのキーを辞書用ホットキーとして使用するかを尋ねるオンボーディングダイアログが表示され、右オプション、右コントロール、F19、Caps Lockなどの選択肢から選べます。選択は~/.bolo/envに保存されます。Boloは、マイクとアクセシビリティのmacOS権限を必要とし、後者は貼り付け挿入を行う~/.bolo/venv/bin/python3の管理されたPythonインタープリターに付与されます。READMEには、インストールと権限付与を案内するプロンプトも含まれています。 文字起こしの流れ:設定したホットキーを押しながら話し、離すと文字起こしが完了します。テキストはクリップボードを介してカーソル位置に挿入され、デフォルトでは元のクリップボード内容は復元されます。メニューバーのアイコンからは、最近の文字起こしをコピーしたり、「文字起こし履歴のクリア」、「ヘルスチェックの実行」、「選択したテキストの書き直し」、「語彙項目の追加」、「語彙エイリアスの追加」、「修正ルールの追加」、「アップデートの確認」などのコマンドを実行できます。 設定:設定は環境変数か~/.bolo/envから読み込まれます。オプションには、TELNYX_API_KEY、プッシュ・トゥ・トーク用のBOLO_HOTKEY(right_option、right_control、right_shift、fn、f1~f19、caps_lock)、最新の文字起こしを再貼り付けするためのBOLO_PASTE_LAST_HOTKEY、BOLO_MICROPHONE、30秒のウォッチドッグデフォルトを持つBOLO_MAX_RECORDING_SECONDS、BOLO_STT_MODELとBOLO_STT_FALLBACK_MODEL、言語やアクセントのヒント用のBOLO_STT_LANGUAGE(US以外のヒントが遅い場合は英語(US)にフォールバック)、telnyx:model、xai、assemblyaiを含むことができるコンマ区切りのプロバイダーチェーンであるBOLO_STT_FALLBACKS、Deepgram Nova-3のストリーミングとバッチ文字起こしを制御するBOLO_STT_STREAMING、BOLO_PRESERVE_CLIPBOARD、BOLO_LLM_CLEANUP、BOLO_AUTO_UPDATE、/tmp/bolo.logから文字起こしを削除するBOLO_LOG_TRANSCRIPTS(デフォルトはオフ)があります。 クリーンアップ、語彙、修正:LLMクリーンアップはデフォルトで自動で、短いクリーンな文字起こしはスキップし、長いまたは乱雑な文字起こしには適用されます。READMEでは、思考を無効にしたTelnyx Qwen/Qwen3-235B-A22B、またはLiteLLMが設定されている場合はKimi-K2.5を使用し、MiniMaxはクリーンアップには意図的に使用しないと記載されています。クリーンアップは、アクセシビリティを介して最前面のアプリとカーソル付近のテキストを読み取り、間隔や大文字小文字を調整できます。音声コマンドには、「scratch that」、「actually ...」、「polish that」、「prompt that」があり、これらは前の文字起こしがまだカーソル直前で完全に一致する場合にのみ動作します。個人語彙は~/.bolo_vocabulary.jsonに保存され、よくある誤認識のエイリアスオブジェクトをサポートしています。決定論的な置換ルールは~/.bolo/replacements.jsonに保存され、アプリごとのクリーンアップスタイルは~/.bolo/prompt_bindings.jsonに、default、email、chat、notesのプロファイルで保存されます。 プライバシーと履歴:音声は文字起こしのためにTelnyx APIに送信され、メモリ内でのみ処理されます。文字起こしはトレーニングには使用されません。最新の10件の文字起こしは~/.bolo/transcripts.jsonにローカルで保存され、クリーンアップがテキストを変更した場合は生とクリーンされた両方のバージョンが保持され、メニューバーから削除できます。 制限事項とメンテナンス:Boloはインターネット接続を必要とし、短い文字起こしは現在うまく機能しますが、長い文字起こしとレイテンシーはまだ改善中です。クリーンアップは、文字通りの意味を保持するために意図的に保守的です。アップデートは起動時またはオンデマンドでチェックされ、ローカルファイルにコミットされていない変更がある場合、GitHubにアクセスできない場合、Rustが欠けている場合、またはチェックアウトがクリーンにファストフォワードできない場合はスキップされます。小さなフレーズベースの評価ハーネス(eval_dictation.py、prompts、init、scoreコマンド付き)が含まれており、トラブルシューティングは/tmp/bolo.log、APIキーの存在、管理されたインタープリターの権限、restart.shに焦点を当てています。