Metadata-Version: 2.4
Name: agent-voice-bridge
Version: 0.1.0
Summary: Remote voice bridge connecting phone browsers to Claude Code
Author: Tuan Son
License-Expression: MIT
Project-URL: Homepage, https://github.com/tuansondinh/lucent-code
Project-URL: Repository, https://github.com/tuansondinh/lucent-code
Project-URL: Issues, https://github.com/tuansondinh/lucent-code/issues
Keywords: claude,voice,speech-to-text,text-to-speech,fastapi
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: claude-agent-sdk>=0.1.51
Requires-Dist: fastapi>=0.111
Requires-Dist: numpy>=1.26
Requires-Dist: onnxruntime>=1.18
Requires-Dist: pydantic>=2.0
Requires-Dist: pywhispercpp>=1.4
Requires-Dist: kokoro>=0.9
Requires-Dist: uvicorn[standard]>=0.29

# 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

```bash
pip install agent-voice-bridge
```

## Requirements

- Python 3.10+
- Claude authentication via one of:
  - `CLAUDE_CODE_OAUTH_TOKEN`
  - `ANTHROPIC_API_KEY`

## Run

```bash
agent-voice-bridge
```

Optional flags:

```bash
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:

```bash
npm run voice-bridge:build
```

Publish to PyPI:

```bash
export PYPI_TOKEN=your-token
npm run voice-bridge:publish
```

Or do both in one step:

```bash
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.
