Vexa Dashboard

100% open source web interface for Vexa - the self-hosted meeting transcription API.

🔒 Own your data. Self-host everything. No cloud dependencies.

📖 Main Repository: This is the web UI for Vexa. For the core API, deployment guides, and full documentation, see the main Vexa repository.

🚀 Deploy in Seconds

docker run -p 3000:3000 \
  -e VEXA_API_URL=http://your-vexa-instance:8056 \
  -e VEXA_ADMIN_API_KEY=your_admin_api_key \
  synapsr/vexa-dashboard

That's it! Open http://localhost:3000 and start transcribing meetings.

💡 Only 3 environment variables needed to get started. All other settings are optional.

✨ Features

🎯 Join Meetings - Send transcription bots to Google Meet and Microsoft Teams
⚡ Real-time Transcription - Watch live transcriptions as they happen during the meeting (sub-second latency via WebSocket)
📝 View Transcripts - Browse and search through meeting transcriptions
🤖 AI Assistant - Chat with your transcripts (OpenAI, Anthropic, Groq, Ollama)
🔌 MCP Integration - Easy setup for MCP-compatible agents (Claude Desktop, Cursor, etc.) to access Vexa capabilities
📤 Export - Download in TXT, JSON, SRT, or VTT formats
👥 User Management - Admin dashboard for users and API tokens
🌙 Dark Mode - System-aware theme switching
📱 Responsive - Works on all devices

Screenshots

Dashboard

Join a Meeting

Live Transcription

Meetings List

Admin - User Management

Admin - Bots Monitoring

🐳 Docker Deployment

Quick Start (Recommended)

Pull and run the pre-built image:

docker run -p 3000:3000 \
  -e VEXA_API_URL=http://your-vexa-instance:8056 \
  -e VEXA_ADMIN_API_URL=http://your-vexa-instance:8057 \
  -e VEXA_ADMIN_API_KEY=your_admin_api_key \
  synapsr/vexa-dashboard

With AI Assistant

Add AI-powered transcript analysis:

docker run -p 3000:3000 \
  -e VEXA_API_URL=http://your-vexa-instance:8056 \
  -e VEXA_ADMIN_API_KEY=your_admin_api_key \
  -e AI_MODEL=openai/gpt-4o \
  -e AI_API_KEY=sk-your-openai-key \
  synapsr/vexa-dashboard

With Email Authentication

Enable Magic Link login with SMTP:

docker run -p 3000:3000 \
  -e VEXA_API_URL=http://your-vexa-instance:8056 \
  -e VEXA_ADMIN_API_KEY=your_admin_api_key \
  -e SMTP_HOST=smtp.resend.com \
  -e SMTP_PORT=587 \
  -e SMTP_USER=resend \
  -e SMTP_PASS=your_smtp_key \
  -e SMTP_FROM=noreply@yourdomain.com \
  synapsr/vexa-dashboard

Docker Compose

services:
  vexa-dashboard:
    image: synapsr/vexa-dashboard
    ports:
      - "3000:3000"
    environment:
      - VEXA_API_URL=http://vexa:8056
      - VEXA_ADMIN_API_URL=http://vexa:8057
      - VEXA_ADMIN_API_KEY=${VEXA_ADMIN_API_KEY}
    restart: unless-stopped

🛠️ Configuration

Required Variables

Variable	Description
`VEXA_API_URL`	Your Vexa API URL (for meetings, transcripts, bots)
`VEXA_ADMIN_API_URL`	Your Vexa Admin API URL (for user management)
`VEXA_ADMIN_API_KEY`	Admin API key from Vexa

Optional Variables

Variable	Description	Default
`DEFAULT_BOT_NAME`	Default name for transcription bots	`Vexa - Open Source Bot`
`AI_MODEL`	AI provider/model (e.g., `openai/gpt-4o`)	-
`AI_API_KEY`	API key for AI provider	-
`SMTP_HOST`	SMTP server for Magic Link auth	-
`SMTP_PORT`	SMTP port	`587`
`SMTP_USER`	SMTP username	-
`SMTP_PASS`	SMTP password	-
`SMTP_FROM`	Sender email address	-
`ALLOW_REGISTRATIONS`	Allow new signups	`true`
`ALLOWED_EMAIL_DOMAINS`	Restrict signup domains	All

AI Providers

# OpenAI
AI_MODEL=openai/gpt-4o

# Anthropic Claude
AI_MODEL=anthropic/claude-sonnet-4-20250514

# Groq (fast & free)
AI_MODEL=groq/llama-3.3-70b-versatile

# Local Ollama
AI_MODEL=ollama/llama3.2
AI_BASE_URL=http://localhost:11434/v1

🔐 Authentication Modes

Direct Login (Default)

Without SMTP configured, users authenticate with just their email (no verification). Great for development and trusted environments.

Magic Link (with SMTP)

With SMTP configured, users receive a secure sign-in link via email. Recommended for production.

💻 Local Development

# Clone
git clone https://github.com/Vexa-ai/vexa-dashboard.git
cd vexa-dashboard

# Install
npm install

# Configure
cp .env.example .env.local
# Edit .env.local with your values

# Run
npm run dev

🏗️ Build from Source

# Build image
docker build -t vexa-dashboard .

# Run
docker run -p 3000:3000 \
  -e VEXA_API_URL=http://your-vexa-instance:8056 \
  -e VEXA_ADMIN_API_URL=http://your-vexa-instance:8057 \
  -e VEXA_ADMIN_API_KEY=your_admin_api_key \
  vexa-dashboard

Tech Stack

Framework: Next.js 16 (App Router)
UI: shadcn/ui + Tailwind CSS
State: Zustand
Language: TypeScript
AI: Vercel AI SDK

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

Apache License 2.0 - see LICENSE for details.

Related Projects

Vexa - Main repository with core API, services, and documentation
- Deployment Guide - Full stack deployment
- Vexa Lite Deployment - Single container deployment
- User API Guide - Complete API reference
vexa-lite-deploy - One-click deployment configurations for Vexa Lite

How It Works

Vexa Dashboard connects to your Vexa API instance (self-hosted or hosted) to provide:

Meeting Management - Join Google Meet and Microsoft Teams meetings with transcription bots
Real-time Transcription - Watch live transcriptions as they happen during the meeting. Transcripts stream in real-time via WebSocket with sub-second latency, so you see what's being said as it happens.
User Management - Admin interface for managing users and API tokens
AI Assistant - Chat with your transcripts using various AI providers

The dashboard is a Next.js application that communicates with Vexa's REST and WebSocket APIs. You can deploy it alongside your Vexa instance or connect it to a remote Vexa API.

🤖 MCP (Model Context Protocol) Integration

Vexa provides easy MCP setup for your AI agents. Connect Claude Desktop, Cursor, or any MCP-compatible client to access Vexa's meeting transcription capabilities directly from your agent.

Quick Setup for Claude Desktop

Get your Vexa API key from your Vexa Dashboard or API settings
Open Claude Desktop Settings → Developer → Edit Config
Add MCP configuration:

{
  "mcpServers": {
    "Vexa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.cloud.vexa.ai/mcp",
        "--header",
        "Authorization:${VEXA_API_KEY}"
      ],
      "env": {
        "VEXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

For self-hosted Vexa, replace https://api.cloud.vexa.ai/mcp with your Vexa API URL (e.g., http://localhost:8056/mcp for Vexa Lite)
Restart Claude Desktop

Your agent can now:

Send bots to meetings
Get real-time transcripts
Access meeting history
Manage users and API tokens

📖 Full MCP setup guide: See the Vexa MCP documentation for detailed instructions and advanced configuration.

Name		Name	Last commit message	Last commit date
Latest commit History 60 Commits
docs/screenshots		docs/screenshots
public/icons		public/icons
src		src
.dockerignore		.dockerignore
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
components.json		components.json
docker-compose.yml		docker-compose.yml
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

Vexa Dashboard

🚀 Deploy in Seconds

✨ Features

Screenshots

Dashboard

Join a Meeting

Live Transcription

Meetings List

Admin - User Management

Admin - Bots Monitoring

🐳 Docker Deployment

Quick Start (Recommended)

With AI Assistant

With Email Authentication

Docker Compose

🛠️ Configuration

Required Variables

Optional Variables

AI Providers

🔐 Authentication Modes

Direct Login (Default)

Magic Link (with SMTP)

💻 Local Development

🏗️ Build from Source

Tech Stack

Contributing

License

Related Projects

How It Works

🤖 MCP (Model Context Protocol) Integration

Quick Setup for Claude Desktop

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages