Voxa

Voxa

Talk to Claude Code from anywhere.
When it finishes, your phone rings.

Website App Store npm PyPI License

Voxa on iPhone: your laptop calls you back, a live voice session with Claude, and the agent's terminal streamed to your phone

Install

Pick your way, same as voxa.space/setup:

macOS / Linux

curl -fsSL https://voxa.space/install.sh | sh

Windows (PowerShell)

irm https://voxa.space/install.ps1 | iex

npm

npm install -g voxa-code

Python

uv tool install voxa-code

Then run voxa on your laptop, scan the QR code with the Voxa iOS app (any phone browser works too), and start talking. Zero config, no API keys: voice runs through the hosted relay, terminal control never leaves your laptop.

Requires: Claude Code installed and logged in.

How it works

  • Speak, don't type. Pick a project, give instructions, hear results read back, fully hands-free.
  • Attach any terminal. iTerm2, Terminal.app, tmux, Ghostty, Warp, VS Code: say "use my open terminal."
  • It calls you back. Leave a task running and pocket your phone. When Claude finishes (or needs input), you get a real incoming call. Answer to land in the live session.
phone ──── voice ────► laptop ────► Claude Code
  ▲                                     │
  └───────── rings when done ◄──────────┘

From source

git clone https://github.com/Ti-03/voxa.git && cd voxa
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/python -m server.cli

Full guide (including fully self-hosted mode, your own keys, no relay): docs/RUNNING.md

FAQ

Is it open source?

Yes. Everything in this repo is MIT: the laptop server, the iOS app, the phone web client, the marketing site, and the cloud pieces (relay + push). You can self-host all of it, or skip that entirely and use our already-hosted services: the default install connects to them out of the box.

Is it free?

Self-hosting is free forever: run the server with your own API key, no relay needed (guide). The hosted zero-config relay is free to get started, with paid plans for more agent minutes (pricing).

What platforms does it support?

The laptop side runs on macOS, Linux, and Windows. The phone side is the Voxa iPhone app, with any mobile browser as a fallback. Attaching to already-open GUI terminals (iTerm2, Terminal.app, Ghostty, Warp, VS Code) is macOS only; tmux attach works everywhere.

Security

Security model and vulnerability reporting: SECURITY.md

Built with ❤️ by Ti  ·  voxa.space  ·  MIT

Project links

Data verified by PyPI on Jul 7, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.109)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ti0 from gravatar.com ti0

Credits

Author: Ti

GitHub Statistics

Data verified by PyPI on Jul 7, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

dev telemetry

Tags

claude claude-code voice cli agent gemini

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

voxa_code-0.1.103.tar.gz (117.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

voxa_code-0.1.103-py3-none-any.whl (132.9 kB view details)

Uploaded Python 3

File details

Details for the file voxa_code-0.1.103.tar.gz.

File metadata

  • Download URL: voxa_code-0.1.103.tar.gz
  • Upload date:
  • Size: 117.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for voxa_code-0.1.103.tar.gz
Algorithm Hash digest
SHA256 8d6256b66cda7d21b0b4ab35c4ce0e3a9f54ae843d424b1bf5bf630a9f3080f0
MD5 2dac667e03195e5160a91c9ef1a27b6c
BLAKE2b-256 342d2efbfbc9c9cbbb2eaa7efbf0a65f4f1e2c074d3d053cb910d0787ada5b56

See more details on using hashes here.

Provenance

The following attestation bundles were made for voxa_code-0.1.103.tar.gz:

Publisher: publish-pypi.yml on Ti-03/voxa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file voxa_code-0.1.103-py3-none-any.whl.

File metadata

  • Download URL: voxa_code-0.1.103-py3-none-any.whl
  • Upload date:
  • Size: 132.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for voxa_code-0.1.103-py3-none-any.whl
Algorithm Hash digest
SHA256 f4dc532655b62b8fb091cf2b6079b409156d5075ade53d4f9f8a0ac750fbbb8b
MD5 78325460a8c115ddced062e59f86960c
BLAKE2b-256 f76c7830462e5d8697a92fd127dec5be3da04b444df4bd40014bc5a4f907d4e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for voxa_code-0.1.103-py3-none-any.whl:

Publisher: publish-pypi.yml on Ti-03/voxa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page