Skip to main content

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 pywhispercpp for 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_TOKEN
    • ANTHROPIC_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_DIR to 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)

Source distribution for agent-voice-bridge 0.1.0
File Size Uploaded
agent_voice_bridge-0.1.0.tar.gz 2.0 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-voice-bridge 0.1.0
File Interpreter ABI Platform
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}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page