Back to Home
Documentation

Quick Start

Prerequisites

  • Python: 3.11+ (backend)
  • Node.js: 18.0+ (frontend)
  • FFmpeg: Latest version (auto-installed)
  • Hardware: 4GB RAM minimum, 8GB recommended

One-Command Setup

# Full application (recommended)
docker-compose up --build

# Or run separately:
# Terminal 1: Backend
cd backend
pip install -r requirements.txt
DEMO_MODE=true python -m uvicorn app:app --host 0.0.0.0 --port 8000

# Terminal 2: Frontend
cd octavia-web
npm install
npm run dev

Access the app at:

  • Frontend: http://localhost:3000
  • Backend: http://localhost:8000

Demo Mode

Test without database setup:

cd backend
DEMO_MODE=true python cli.py test-integration --comprehensive --input test_samples/sample_30s_en.mp4

Demo Credentials:

  • Email: demo@octavia.com
  • Password: demo123