Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vexa.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
0.10.0 (April 2026)

Major architectural refactor. If upgrading from 0.9.x or earlier, read the migration guide below.

​
What’s new

  • Monorepo architecture — All services now live in a single repository under services/
  • Meeting API — New dedicated service for bot lifecycle, recordings, and webhooks (replaces the bot-manager monolith)
  • Runtime API — Container orchestration with Docker, Kubernetes, and process backends
  • Agent API — AI agent chat runtime with ephemeral containers
  • Interactive bots — Speak (TTS), chat read/write, screen share, virtual camera via REST API
  • Vexa Lite — Single-container deployment with all services bundled via supervisord
  • Recording storage — S3, MinIO, and local storage backends for audio recordings
  • MCP server — 17 tools for Claude, Cursor, and Windsurf integration
  • Dashboard — Next.js web UI for meetings, transcripts, agent chat, and recordings

​
Breaking changes

ChangeBefore (0.9.x)After (0.10.0)Action required
Service splitbot-manager monolithmeeting-api + runtime-apiUpdate compose/helm configs
Package layoutpackages/services/Update any custom scripts referencing package paths
Auth headerBearer token (some endpoints)X-API-Key header everywhereUpdate API clients
API URL (hosted)gateway.dev.vexa.aiapi.cloud.vexa.aiUpdate integration URLs
Docker imagesvexaai/vexa-bot:devvexaai/vexa-bot:latest or immutable tagUpdate image references
Transcription configWHISPER_* env vars in botTRANSCRIPTION_SERVICE_URL + TRANSCRIPTION_SERVICE_TOKENSet new env vars

​
Migration guide (self-hosted)

1

Back up your database

The schema migration is additive-only (new columns, never drops). Rollback is safe, but back up first.
pg_dump -Fc your_vexa_db > vexa-backup-pre-0.10.sql
2

Pull the new code

cd vexa
git fetch origin
git checkout main
git pull
3

Update environment variables

Compare your .env with deploy/env-example:
diff .env deploy/env-example
Key new variables:
  • TRANSCRIPTION_SERVICE_URL (required) — transcription endpoint
  • TRANSCRIPTION_SERVICE_TOKEN (required) — transcription API key
  • OPENAI_API_KEY (optional) — for TTS/speaking bot feature
  • STORAGE_BACKEND (optional) — local, minio, or s3
4

Rebuild and restart

make all
This rebuilds images from the new architecture and runs migrations automatically.
5

Verify

# Check services are running
make ps

# Quick API test
curl http://localhost:8056/docs
API URL change for hosted users: If your integrations use gateway.dev.vexa.ai, update them to api.cloud.vexa.ai. The old URL may stop working.

​
Vexa Lite (new deployment option)

If you were running Docker Compose for a simple self-hosted setup, consider switching to Vexa Lite — a single container that bundles all services. Much simpler to operate.

​
0.9.x and earlier

See GitHub releases for historical changelog.