Set up Voxa

Voxa runs on your own laptop. Here is how to get it going.

Prerequisites

  • Python 3.11 or newer on the laptop.
  • Tailscale installed and logged in on both the laptop and the phone.
  • A Gemini API key from Google AI Studio with Gemini Live access.
  • Claude Code logged in on the laptop.

1. Create the environment

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"

2. Configure secrets

cp .env.example .env

Fill in GEMINI_API_KEY and VOXA_AUTH_TOKEN (any random secret string).

3. Start the server

bash scripts/serve.sh

It starts the server, exposes it over your tailnet via HTTPS, and prints the URL plus a QR code to scan.

4. Connect from your phone

Open the printed URL or scan the QR code, tap Connect, and start talking.