agent-voice-bridge
agent-voice-bridge exposes a phone-friendly web UI and WebSocket bridge for
voice conversations with Claude Code.
It runs local speech models on the host machine:
- Silero VAD for voice activity detection
- whisper.cpp via
pywhispercppfor speech-to-text - Kokoro for text-to-speech
- FastAPI + Uvicorn for the web bridge server
Install
pip install agent-voice-bridge
Requirements
- Python 3.10+
- Claude authentication via one of:
CLAUDE_CODE_OAUTH_TOKENANTHROPIC_API_KEY
Run
agent-voice-bridge
Optional flags:
agent-voice-bridge --host 127.0.0.1 --port 8787 --model sonnet
When the server starts it prints local and network URLs that can be opened on a phone browser.
Release
Build the PyPI artifacts:
npm run voice-bridge:build
Publish to PyPI:
export PYPI_TOKEN=your-token
npm run voice-bridge:publish
Or do both in one step:
export PYPI_TOKEN=your-token
npm run voice-bridge:release
Notes
- The package persists its auth token under
~/.agent-voice-bridge/by default. - Set
VOICE_BRIDGE_STATE_DIRto override that location. - Model downloads may happen on first use depending on the underlying speech libraries.
Release files for agent-voice-bridge 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_voice_bridge-0.1.0.tar.gz | 2.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_voice_bridge-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.0 MB
Release files / agent_voice_bridge-0.1.0.tar.gz
| Download URL | agent_voice_bridge-0.1.0.tar.gz |
|---|---|
| Size | 2.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
aa1d9d75c94bf45eb504a74acd024e4e6f584de0d6a9501acaceca778d3bc55b
|
|
BLAKE2b-256 checksum How to use checksums |
082e5ab853fea35750e5e15c40f2b2d6fb64bca4c59ed101e53cd2e0db448afd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / agent_voice_bridge-0.1.0-py3-none-any.whl
| Download URL | agent_voice_bridge-0.1.0-py3-none-any.whl |
|---|---|
| Size | 2.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a41d4a91c30808f1ae55fa8989032183484250e25579629fa9d60185d12cc40
|
|
BLAKE2b-256 checksum How to use checksums |
4ec5c21e4d23dfc7a313cfb93fd8e5b22714eaa96dc7567b8bf2949516cdc322
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|