VoPro Documentation

Complete technical documentation for the VoPro voice-to-operations system.

System Overview

Introduction to the VoPro platform by Patrick Neiler

What is VoPro?

VoPro is a real-time voice-to-operations platform that captures audio input, transcribes it, and intelligently orchestrates actions across multiple databases and integrations. The entire system is self-contained within the lib/vopro directory for easy integration.

Core Features

Self-Contained Library - All code lives in lib/vopro/
Drop-in Route Handlers - Export handlers with spread operators
Real-time Audio Capture - WebSocket-based audio streaming
AI Transcription - Deepgram or OpenAI Whisper integration
AI Orchestration - Vercel AI Gateway with structured output
Action Execution - Automatic execution of approved actions
Provider Abstraction - Support for Supabase, Notion, Procore
Draft Management - Review and approve actions before publishing

Quick Start

// 1. Set up API routes (one-liners!)
// app/api/vopro/process/route.ts
export { POST } from "@/lib/vopro/api/handlers/process"

// app/api/vopro/actions/route.ts
export { GET, POST } from "@/lib/vopro/api/handlers/actions"

// app/api/vopro/sessions/route.ts
export { GET, POST, PATCH } from "@/lib/vopro/api/handlers/sessions"

// 2. Add VoProClient to your layout
import { VoProClient } from '@/lib/vopro'

<VoProClient userId="user-123" />

Architecture

Multi-layer system design

┌─────────────────────────────────────────────────────────────────┐
│                     CLIENT INTERFACE                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │  VoProFAB   │  │   Session   │  │    Action Review        │  │
│  │  (Record)   │  │   Popover   │  │    (Accept/Reject)      │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    AI ORCHESTRATION LAYER                        │
│  ┌─────────────────────────────────────────────────────────────┐│
│  │            AIOrchestrator (Vercel AI Gateway)                ││
│  │  - Analyzes transcript with structured output                ││
│  │  - Extracts actionable items via tool calls                  ││
│  │  - Routes to specialized tool agents                         ││
│  └─────────────────────────────────────────────────────────────┘│
│         │                    │                    │              │
│         ▼                    ▼                    ▼              │
│  ┌───────────┐        ┌───────────┐        ┌───────────┐        │
│  │   Task    │        │  Meeting  │        │  Project  │        │
│  │   Agent   │        │   Agent   │        │   Agent   │        │
│  └───────────┘        └───────────┘        └───────────┘        │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      DATA LAYER                                  │
│  ┌─────────────────────────────────────────────────────────────┐│
│  │              Provider Abstraction Layer                      ││
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐                   ││
│  │  │ Supabase │  │  Notion  │  │  Procore │                   ││
│  │  └──────────┘  └──────────┘  └──────────┘                   ││
│  └─────────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────────┘

VoPro Voice-to-Operations System

Invented and developed by Patrick Neiler