comex-voice-assistant / README.md

Comex Voice Assistant

Last updated: 4/16/2026GitHub

Comex Voice Assistant

Follow these steps to set up and run the project locally.


⚙️ Setup Options

Option 1: Minimal / Quick Setup (if you just want to build and run locally)

  1. Rename .env.sample in agent/ to .env

  2. Run:

    make build
    

Option 2: Manual

1️⃣ Backend Setup

  1. Install LiveKit Server

    livekit-server --dev
    
  2. Install uv (if not already installed)

  3. Sync dependencies

    uv sync
    
  4. Start the agent

    uv run agents.py start
    
  5. Run the FastAPI server

    uv run fastapi run server.py
    

2️⃣ Frontend Setup

  1. Install Bun (if not already installed)

  2. Navigate to the frontend directory and install dependencies

    cd frontend
    bun install
    
  3. Build and start the frontend

    bun build
    bun run start
    

✅ You’re good to go!