Voxta docs
Voxta ServerGet Started

Your first conversation

From a fresh Voxta install to your first voice chat in five minutes.

This walks you from "Voxta is installed" to "Voxta is talking back." If you haven't installed yet, start with Install Voxta Server.

What you'll do

  1. Run the first-launch wizard to pick services.
  2. Connect either Voxta Cloud (easiest) or a local model (free, needs a GPU).
  3. Open a chat with a default character.
  4. Type or speak. Listen to the reply.

Pick a starting path

Path A — Voxta Cloud (easiest)

Plug in an API key from portal.voxta.ai. No local model setup. Burns credits but works instantly.

Path B — Fully local

Local LLM, local voice, local transcription. Free to run. Needs a recent GPU with enough VRAM.

You can switch between them later, or run both side by side. Pick whichever fits what you have today.

Run the wizard

Launch Voxta

Double-click Voxta.DesktopApp.exe. The Voxta UI opens automatically — usually inside a wrapper window, or in your browser at http://127.0.0.1:5384/ if you ran Voxta.Server.exe directly.

Walk through the wizard

On first launch Voxta shows a setup wizard that asks which services you want to install. Pick:

  • Path A (Voxta Cloud) — choose Voxta Cloud as your LLM, TTS, and STT provider. The wizard asks for your API key from portal.voxta.ai (see Voxta Cloud: Getting Started).
  • Path B (Local) — pick a local LLM service like llama.cpp or ExLlamaV2 for text, Coqui XTTS or Kokoro for voice, Vosk or WhisperLive for transcription.

You can skip the wizard and configure services manually in Manage Services later. The wizard is just a friendlier on-ramp.

Wait for service installation

Local services that ship as Python modules will install their dependencies on first run — this can take a few minutes the first time, since the installer fetches model weights and Python packages. Cloud services are instant.

Set up your profile

Voxta uses your profile as the "user" side of the chat — it's how characters know what to call you and how to address you. Set a display name and (optionally) a short bio. You can edit this any time in Profile.

Start a chat

Open the Characters list

In the Voxta UI, go to Characters. Voxta ships with at least one default character — pick any of them, or click Create to make your own (you can come back to this later, see Studio → Characters).

Start a new chat

Click Start New Chat. Voxta loads the character's prompt, opens a Chat panel, and the AI is ready.

Say something

  • Type into the input box and press Enter, OR
  • Speak — if you wired up STT, just talk. The character's reply plays back through your selected TTS voice.

The character should respond within a couple of seconds. If it doesn't, jump to Troubleshooting.

Where to go next

On this page