Vowel Core

Self-hosted token service + Web UI for the vowel platform. Ephemeral token minting for Vowel Engine, OpenAI Realtime, and Grok Realtime. Create apps, API keys, and generate tokens.

⚠️ Beta Release — This open-source release is in beta. You may encounter rough edges, incomplete features, or breaking changes. We are actively reviewing and merging community PRs, but please expect some instability as we iterate toward a stable release. Your feedback and contributions are welcome.

Quick Start

bun install
cd ui && bun install
cd .. && bun run db:init
bun run dev          # Elysia API (standalone, serves built UI if present)
bun run dev:ui      # vinext dev server (UI only, proxies /api/* to API)

For full dev with hot reload: run bun run dev:api (API on 3001) and bun run dev:ui (UI on 3000). Or build UI once and use Elysia standalone:

bun run build       # Build vinext UI to ui/dist
bun run dev         # Elysia serves API + static UI

Or run both dev servers concurrently from one command:

bun run dev:stack

Open http://localhost:3000

Tests

bun test

Cloudflare Tunnel

For local dev with a public URL (e.g. WebSocket testing):

bun run dev:tunnel

This starts Core API + UI in dev mode and immediately starts the Cloudflare tunnel. If API or UI are already running, dev:tunnel will reuse them and avoid starting duplicate dev processes. Requires CLOUDFLARE_TUNNEL_TOKEN in .env. See docs/CLOUDFLARE_TUNNEL.md.

Environment options:

bun run dev:tunnel:testing   # uses testing-core.vowel.to
bun run dev:tunnel:dev       # uses core-dev.vowel.to
bun run dev:tunnel:staging   # uses staging-core.vowel.to
bun run dev:tunnel:production # uses core.vowel.to (requires caution)

Environment

See .env.example for required variables.