AI Voice Bridge v3.1 - macOS Whisper Edition
Copyright 2026 Reasonable IT Service. All rights reserved.
Website: https://www.reasonableitservice.com

Not affiliated with, endorsed by, or sponsored by OpenAI, Anthropic, DeepSeek, Google, or xAI.
ChatGPT, Claude, DeepSeek, Gemini, and Grok are trademarks of their respective owners.

OVERVIEW
AI Voice Bridge is a local voice bridge for supported AI chat websites in Google Chrome.
It adds local dictation, local readback, a floating Mic | Repeat | Stop control, and a simple voice command for sending messages.

Supported sites:
- ChatGPT: chatgpt.com / chat.openai.com
- Claude: claude.ai
- DeepSeek: chat.deepseek.com
- Gemini: gemini.google.com
- Grok: grok.com

WHAT'S NEW IN v3.1
- DeepSeek readback now captures the complete final answer while excluding visible Thought/reasoning content.
- Local dictation now uses the AudioWorklet recording path with retry handling and improved background-tab reliability.
- Local readback stop/restart handling is more resilient, reducing stuck or overlapping speech.
- Grok browser support is included alongside the existing ChatGPT, Claude, DeepSeek, and Gemini connectors.
- Existing controls, hotkeys, privacy behavior, and the five-minute recording limit are maintained.

WHAT IT DOES
1. Local dictation
   Click the Mic button, speak, then stop recording. Audio is sent only to the local server on the same Mac, transcribed locally with Whisper, and inserted into the AI prompt box.

2. Stop and repeat local readback
   Click the red Stop button to stop current read-aloud speech. This does the same job as Esc.
   Click the green Repeat button to replay the latest captured AI response from the beginning using the local RITS/system voice path.
   Native ChatGPT/Claude read-aloud triggering is not included in this build.

3. Voice command send
   If your dictation ends with the exact phrase "send message" or "send a message", the bridge strips the command and submits the remaining prompt automatically.

Example:
You say: Explain this in one paragraph send message
The AI site receives: Explain this in one paragraph

The command only triggers when the send phrase is the final phrase. Saying something like "send message to the client" will not trigger auto-send.

CONTROLS
- Click the Mic icon: start recording
- Mic turns red while recording
- Click the Mic icon again: stop recording and transcribe
- Enter while recording: stop recording and transcribe
- Local dictation maximum recording time: 5 minutes per recording. At 5 minutes, recording automatically stops and transcribes.
- Cmd+Shift+V: start/stop dictation
- Click the red Stop button: stop current read-aloud speech
- Click the green Repeat button: replay the latest captured AI response from the beginning
- Esc inside the AI site tab: emergency stop for current read-aloud speech

FLOATING MIC | REPEAT | STOP CONTROL
The floating Mic | Repeat | Stop control uses stable automatic placement logic.
It docks near the supported chat composer when a safe placement is found.
If the page layout changes, the screen is too narrow, or the dock would overlap native controls, it falls back to the stable bottom-left placement.

You can move the control manually:
- Drag the middle divider/handle between Mic and Repeat/Stop to move the control
- The position is remembered per site/browser
- Double-click the middle divider/handle to reset back to the default placement

PRIVACY / SAFETY
- No cloud TTS
- No API key
- No RITS account
- No startup service
- No telemetry
- Nothing runs unless you launch it
- The server listens only on 127.0.0.1:5055
- Dictation audio is sent only from Chrome to the local server on the same computer
- The AI platform receives the final text prompt only when you submit it
- Raw microphone audio is not sent to ChatGPT, Claude, DeepSeek, Gemini, or Grok by AI Voice Bridge

LICENSE / USAGE TERMS
AI Voice Bridge is free to use, but it is not open-source.
You may install and use unmodified copies for personal or business use.
You may not copy, modify, redistribute, resell, rebrand, sublicense, publish the source code from, or create derivative products based on this software without written permission from Reasonable IT Service.
See LICENSE.txt for full terms.

IMPORTANT
Keep the AI Voice Bridge server window open while using supported AI sites.
Only one server can run at a time because the app uses local port 5055.

MAC REQUIREMENTS
- macOS
- Google Chrome
- Python 3 (installer included in payload folder)
- Microphone permission for Chrome

INSTALL / UPDATE
1. Run Run-AI-Voice-Bridge-Mac-Installer.command.
2. The installer copies the app to: ~/Documents/RITS-AI-Voice-Bridge
3. A Desktop launcher app named RITS AI Voice Bridge.app is created automatically.
4. Launch the local server with Start-AI-Voice-Bridge.command or the Desktop launcher app.
5. In Chrome, load the unpacked extension from:
   ~/Documents/RITS-AI-Voice-Bridge/voice-bridge-extension
6. Open ChatGPT, Claude, DeepSeek, Gemini, or Grok in Chrome.
7. Use the floating Mic | Repeat | Stop control, Enter-to-stop, hotkey dictation, or final phrase auto-send.

TROUBLESHOOTING
- If dictation says it failed or shows Failed to fetch, make sure the AI Voice Bridge application/terminal is running.
- If the Mic button does not appear: reload the Chrome tab and confirm the extension is loaded.
- If Chrome blocks the microphone: check Chrome site permissions and macOS Privacy & Security microphone permissions.
- If the floating control is in a bad location: double-click the middle divider/handle to reset its position.
- If local readback does not speak: confirm the server is running and system audio is not muted.
- After updating or reloading the Chrome extension, refresh any open ChatGPT, Claude, DeepSeek, Gemini, or Grok tabs before testing Mic again.
