VILab

VILab is a desktop-first voice platform that can also expose a reusable HTTP layer for LAN clients and self-hosted integrations.

What this documentation covers

• Running the desktop host locally
• Exposing the embedded HTTP service to your LAN
• Managing adminKey and external API keys
• Calling /health, /v1/models, and /v1/audio/transcriptions
• Working with transcript output variants such as raw, smart_clean, and polished
• Using Prompt Lab to compare prompt presets and provider/model behavior without polluting history
• Troubleshooting common self-hosted errors

Product model

• The desktop app is the first host of the VILab voice layer.
• The embedded HTTP service is the LAN and self-hosted entry point.
• The open source/self-hosted flow does not require account registration or login.
• A future cloud offering, if it exists, is a separate product layer and does not change the self-hosted flow.

Recommended LAN topology

+----------------------------------+
| Host machine running VILab       |
| - Desktop app                    |
| - Embedded HTTP service          |
| - Admin-only key management      |
+----------------+-----------------+
                 |
      Bearer external API key
                 |
   +-------------+-------------+-------------+
   |             |             |             |
 Web app    Script/CLI      Device     Internal tool

First read

• Quick Start
• LAN Deployment
• API Keys
• API Reference