Octavia | Universal AI Translation

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`