Voxta docs
Voxta ServerGet Started

Install Voxta

Download, run the installer, launch — Voxta installed and running in under five minutes. Plus portable, Lite, mobile, and Linux options.

Voxta ships in several flavors. Pick the one that matches what you're doing, then follow the install steps for that flavor:

FlavorFilename patternWhat it is
Desktop App (installer)Voxta.DesktopApp.Setup.vX.Y.Z.exeFull Voxta with an NSIS installer. Handles install + updates. Recommended for most users.
Desktop App (portable)Voxta.DesktopApp.vX.Y.Z.zipSame full Voxta, no installer. Extract and run.
Desktop App LiteVoxta.DesktopAppLite.vX.Y.Z.zipSlim build — Voxta Cloud only, no local-AI modules. Best for trying Voxta without local setup.
Mobile (Android)ai.voxta.mobile.vX.Y.Z-Signed.apkVoxta on your phone. Also Voxta Cloud only. Early build.
Server (Linux)Voxta.Server.Linux.vX.Y.Z.zipHeadless server build for Linux.

All editions live on portal.voxta.ai/downloads/voxta-server.

Prerequisites

  • A Patreon subscription on any Voxta tier — gates the portal download.
  • Your Discord account linked to Patreon.
  • Windows 10 or 11 for the Desktop App, Android 10+ for Mobile, Linux for the headless server build.
  • For local LLMs / local voices: a recent NVIDIA GPU with enough VRAM.
  • For Voxta Cloud / cloud LLMs: just an internet connection.

Install

The full Voxta experience via NSIS installer. Auto-handles install location, Start Menu shortcuts, and updates.

Download the installer

Sign in to portal.voxta.ai/downloads/voxta-server and grab the latest Voxta.DesktopApp.Setup.vX.Y.Z.exe (marked primary on the portal).

Run the installer

Double-click the .exe and follow the wizard. Default install location is fine for most users.

Windows SmartScreen may flag the installer on first download. Click More info → Run anyway to allow it.

Launch Voxta

Use the Start Menu shortcut or desktop icon. The Voxta Desktop App (a WPF + WebView2 wrapper) opens and loads the Voxta UI automatically.

Continue setup

The first-launch wizard walks you through picking services. See Your first conversation.

Same full Voxta as the installer, just unpacked from a ZIP. Useful for portable installs, multiple copies side-by-side, or if you'd rather not run an installer.

Install the Microsoft Visual C++ Redistributable

Voxta needs the Microsoft Visual C++ Redistributable (x64). Most Windows machines already have it.

Download the portable ZIP

From the portal Downloads page, grab Voxta.DesktopApp.vX.Y.Z.zip (no "Setup" in the name).

Extract to a folder without spaces

  • ✅ Good: C:\Voxta, D:\Apps\Voxta
  • ❌ Bad: C:\Program Files\..., paths with spaces, OneDrive-synced folders.

Run Voxta.DesktopApp.exe

Same launcher as the installed version, just unpacked. Or run Voxta.Server.exe directly and open http://127.0.0.1:5384/ in your browser.

A slim build of Voxta with only the Voxta Cloud module bundled. No local LLMs, no local TTS, no local STT — everything goes through Voxta Cloud, which means no local AI setup at all.

The Voxta UI, Studio, characters, scenarios, scripting — all the same as the full version. Just the AI backend is restricted to Voxta Cloud.

Download Lite

From the portal Downloads page, grab Voxta.DesktopAppLite.vX.Y.Z.zip.

Extract and launch

Unzip somewhere convenient. Run Voxta.DesktopApp.exe.

Connect to Voxta Cloud

Open the portal, generate an API key, paste it in the Voxta Cloud service config. See Voxta Cloud → Getting Started for the full flow.

Voxta runs as a native Android app — the full Voxta server runs in-process on your phone, with the UI rendered in a WebView. Currently Voxta Cloud only (no local AI on mobile) and Android-only (no iOS yet).

Mobile is an early build. It works, but expect rough edges compared to the desktop apps.

Enable installation from APK on your phone

Android blocks APK installs from outside the Play Store by default. Allow it for your browser or file manager via Settings → Apps → [your app] → Install unknown apps.

Download the APK

From the portal Downloads page, grab ai.voxta.mobile.vX.Y.Z-Signed.apk. Easiest to do this directly on your phone — open the portal in your phone's browser and tap the download.

Install

Tap the downloaded APK in your phone's notification shade or file manager. Android prompts you to confirm — accept.

Generate an API key on the portal

Mobile only talks to Voxta Cloud, so you need an API key. On any device, sign in to portal.voxta.ai, generate an API key, copy it.

Open the Voxta app and paste your key

Launch Voxta on your phone. Paste your API key when prompted. You can now chat with characters from your phone.

Linux support is partial. Some Voxta Studio features assume Windows. Stick with Windows if you can. Linux is useful for headless server deployments.

Use the Linux server ZIP — there's no Linux installer or desktop wrapper.

Install Python 3.12 and dev libraries

sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update
sudo apt upgrade -y
sudo apt install python3.12 python3.12-dev python3.12-venv python3-pip -y

Install Voxta system dependencies

sudo apt install ffmpeg libopenal-dev -y

For NVIDIA GPU services:

sudo apt-get install cudnn9-cuda-12

Extract the Linux ZIP

From the portal, grab Voxta.Server.Linux.vX.Y.Z.zip. Extract to a path without spaces.

Set up the Python venv

From inside the Voxta folder:

python3.12 -m venv Data/Python/python-3.12-venv

Create ffmpeg.config.json

In the root of the Voxta folder:

{
  "BinaryFolder": "/usr/bin/ffmpeg",
  "TemporaryFilesFolder": "/tmp"
}

Launch

Run Voxta.Server from the install folder. Open http://127.0.0.1:5384/ in your browser.

What's next

On this page