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:
- macOS
- Google Chrome
- Python 3
- Built-in macOS speech


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.

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

If macOS blocks the installer:
1. Open System Settings.
2. Go to Privacy & Security.
3. Scroll down to the Security section.
4. Click Open Anyway next to Run-RITS-Mac-Installer.command.
5. Confirm and run the installer.

This is expected because the installer is not yet Apple-signed or notarized.

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

Please install Python 3 and rerun this installer.

Easiest option:
Go to python.org, download the latest Python 3 macOS installer, install it, then rerun this installer.

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

Please install Google Chrome for macOS 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.

Daily use:
1. Double-click Start-RITS-Local-AI-Voice-Bridge.command.
2. Keep the Terminal/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 Terminal/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 Terminal/server window is open.
- If the Terminal/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-Mac
