RITS Local AI Voice Bridge 1.0
Copyright 2026 Reasonable IT Service. All rights reserved.
Website: https://www.reasonableitservice.com

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

What this is:
A local voice bridge for supported AI chat websites in Google Chrome.
It watches supported AI responses in Chrome, sends the text to a local server on 127.0.0.1:5055, and reads it aloud using your computer's built-in speech engine.

Compatible sites:
- ChatGPT: chatgpt.com / chat.openai.com
- Claude: claude.ai
- DeepSeek: chat.deepseek.com

Important:
The local voice bridge server must be running while you use this product.
Keep the server window open while using supported AI sites.
If you close the server window, the voice bridge stops working until you launch it again.

Compatibility note:
ChatGPT uses the most-tested connector.
Claude and DeepSeek use supported connectors. AI websites can change their page structure over time, so connectors may need future updates.

Requirements:
- Windows 10 or Windows 11
- Google Chrome
- Python 3
- Built-in Windows speech

Windows prerequisite check note:
The installer checks for Google Chrome in the standard Chrome install locations. Microsoft Edge, Chromium, or other browsers do not count. Google Chrome must be installed before running the installer.


Voice behavior:
- Mac uses the current default macOS system voice at a tuned speaking rate of 155.
- Windows uses the current default Windows speech voice at normal rate 0 and volume 100.
- To change the voice, change the operating system's default speech voice. The bridge does not hard-code a custom personal voice in this stable customer build.

Privacy / safety notes:
- No cloud TTS.
- No API key.
- No account.
- No startup service.
- No telemetry.
- Nothing runs unless you launch it.
- The server only listens on 127.0.0.1:5055.
- Chat text is sent only from the Chrome extension to the local voice bridge server on the same computer.

Windows installer instructions:
1. Extract this ZIP.
2. Double-click Run-RITS-Windows-Installer.bat.
3. The installer checks for Python 3 and Google Chrome first.
4. If either requirement is missing, the installer stops and tells you what to install.
5. If both are found, it copies the prebuilt files to:
   Documents\RITS-Local-AI-Voice-Bridge-Windows
6. Open Chrome and go to chrome://extensions.
7. Turn Developer mode ON.
8. Click Load unpacked.
9. Select:
   Documents\RITS-Local-AI-Voice-Bridge-Windows\voice-bridge-extension
10. Double-click:
   Documents\RITS-Local-AI-Voice-Bridge-Windows\Start-RITS-Local-AI-Voice-Bridge.bat
11. Keep the server window open while using supported AI sites.
12. Open ChatGPT, Claude, or DeepSeek in Chrome and send a fresh message.
13. Click Allow if Chrome asks the site to access other apps and services on this device.

If Python 3 is missing:
Python 3 was not detected.

Please install Python 3 and rerun this installer.

Easiest option:
Open Microsoft Store, search for Python, and install the latest Python 3 version from the Python Software Foundation.

If Google Chrome is missing:
Google Chrome was not detected.

Please install Google Chrome and rerun this installer.

Important Chrome permission prompt:
The first time a supported AI site sends text to the local voice bridge, Chrome may show this prompt near the top-left of the browser window:

[site name] wants to access other apps and services on this device

Examples:
chatgpt.com wants to access other apps and services on this device
claude.ai wants to access other apps and services on this device
chat.deepseek.com wants to access other apps and services on this device

Click Allow.

This allows the AI website in Chrome to talk to the local voice bridge server running on your own computer at 127.0.0.1:5055.

Optional microphone permission:
If you use built-in voice input or dictation on an AI site, Chrome may also ask to use your microphone.
Click Allow only if you want to speak prompts into that site.
This microphone permission is separate from RITS Local AI Voice Bridge. The voice bridge reads responses aloud and does not require microphone access.

Possible Windows security warning:
Because this is a package and not a signed Windows app, Windows may show a warning when opening the downloaded installer.
Only continue if the package came directly from Reasonable IT Service or a trusted RITS download location.

Manual install fallback if the BAT installer is blocked:
Use this if Windows, antivirus, SmartScreen, or company policy blocks Run-RITS-Windows-Installer.bat.

1. Extract the ZIP.
2. Open Documents.
3. Create this folder:
   RITS-Local-AI-Voice-Bridge-Windows
4. Open the extracted installer folder.
5. Open the payload folder.
6. Copy everything inside payload into:
   Documents\RITS-Local-AI-Voice-Bridge-Windows
7. Copy the top-level README.txt into that same Documents folder if it is not already there.
8. Confirm this file exists:
   Documents\RITS-Local-AI-Voice-Bridge-Windows\voice-bridge-extension\manifest.json
9. Open Chrome and go to chrome://extensions.
10. Turn Developer mode ON.
11. Click Load unpacked.
12. Select:
    Documents\RITS-Local-AI-Voice-Bridge-Windows\voice-bridge-extension
13. Start the local voice bridge server.

Preferred start method:
Double-click:
Documents\RITS-Local-AI-Voice-Bridge-Windows\Start-RITS-Local-AI-Voice-Bridge.bat

If the start BAT is also blocked, start it manually from Command Prompt:

cd /d "%USERPROFILE%\Documents\RITS-Local-AI-Voice-Bridge-Windows"
py -3 speaker_server_windows.py --port 5055 --rate 0 --volume 100

If py is not available, try:

python speaker_server_windows.py --port 5055 --rate 0 --volume 100

or:

python3 speaker_server_windows.py --port 5055 --rate 0 --volume 100

Keep the Command Prompt window open while using supported AI sites.
Closing the window stops the voice bridge.

Daily use:
1. Double-click Start-RITS-Local-AI-Voice-Bridge.bat.
2. Keep the server window open.
3. Open ChatGPT, Claude, or DeepSeek in Chrome.
4. Use the AI site normally.
5. Press Esc in the AI site tab to stop speech.
6. Close the server window when finished.

Known limitations:
- Very large or long-running chats may be less reliable because the browser page contains a lot of old message history. For best reliability, start a fresh chat when using the voice bridge for active work.
- If one site does not speak, the connector may need adjustment for that site's current page layout.

Troubleshooting:
- If nothing speaks, confirm the server window is open.
- If the server window shows no POST /speak entries, reload the Chrome extension and refresh the AI site.
- If Chrome asked to access other apps and services and you clicked Block, reset site permissions for that AI site and try again.
- If speech starts but Esc does not stop it, click inside the AI site tab first, then press Esc again.
- If Python was installed after the installer was already open, close the installer window and rerun it.

Uninstall:
1. Remove the RITS Local AI Voice Bridge extension from chrome://extensions.
2. Delete:
   Documents\RITS-Local-AI-Voice-Bridge-Windows
