A voice assistant that lives on your desktop —
not in the cloud.

Features

Everything on board. Nothing phoning home.

Get started

From clone to conversation in three steps.

Prerequisites: Rust (stable) and Node 18+. On Linux also libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf.

Get Voxa on GitHub

1. 1

   Build & run the orb

   Copy

   # dev build (or: npm run tauri build)
   git clone https://github.com/przemekzur/voxa.git
   cd voxa/packages/orb
   npm install
   npm run tauri dev

   That's it — the orb auto-starts the connector harness (tools + memory brain, all connectors enabled) and stops it when you quit. Prefer to run it yourself? cd packages/harness && npm start — the orb detects it and won't start a second one.

2. 2

   Paste a key, allow the mic

   Tap the orb and paste a Gemini API key when prompted — it's stored locally, never in the config file.

   💡 Gemini Live is free to use in Google AI Studio — create a key at no cost and the realtime voice model runs on the free tier. No billing setup required.
3. 3

   Talk

   “Remember that the standup moved to 10am.”

   Saved to your notes. 📝

   “…what time is standup?”

   Your standup is at 10am — you moved it earlier today.

Configure it

One gear. Everything behind it.

Everything is one tap from the orb's gear:

• Skins, palettes, layouts live right in the panel.
• ⚙ Settings… opens voice provider (Gemini / OpenAI / local daemon), voice model & voice, API keys, persona, and the brain folder — with an Open folder button.
• 🔌 Connectors… opens the connector manager as an app window (also at http://localhost:3010). Every connector ships enabled by default; Enable all / Disable all flips the whole set.
• Settings are written to voxa-config.json in your app-data dir — plain JSON you can edit by hand.

Connectors

Three ways to teach Voxa a new trick.

A connector gives Voxa new voice-callable tools. It's a single ES module — no build step, no dependencies beyond Node's stdlib and global fetch. The harness auto-discovers anything in packages/harness/connectors/<id>/index.mjs.

// packages/harness/connectors/dice/index.mjs
export default {
  id: "dice",
  name: "Dice",
  description: "Roll dice.",
  icon: "🎲",
  config: [],               // optional config/secret fields
  async test() { return { ok: true, message: "Ready." }; },
  actions: [
    {
      name: "dice_roll",   // GLOBALLY unique — prefix with the id
      description: "Roll an N-sided die and return the result.",
      parameters: {         // JSON Schema for the args (flat, typed)
        type: "object",
        properties: { sides: { type: "number",
          description: "Number of sides (default 6)." } },
      },
      async handler(args) {
        const n = Math.max(2, Math.floor(args.sides || 6));
        return { result: `You rolled a ${1 + Math.floor(Math.random() * n)} (d${n}).` };
      },
    },
  ],
};

# the whole contract
GET  /api/voice/tools   # → list of tool manifests
POST /api/voice/tools   # → run a tool, return { result }

Ships with 21 connectors — every one a single small file

Platforms

One app. Three operating systems.

Voxa is a Tauri v2 app. Every push builds the orb on Windows, macOS, and Linux in CI.

cd packages/orb
npm install
npm run tauri build              # release installers for the host OS
npm run tauri build -- --no-bundle   # compile only (what CI runs)