Setup Guide

Getting started with your local instance.

Set up the FastAPI backend, configure database connections, run the optional Colab GPU proxy, and spin up the Next.js studio.

1. Instructions2. Setup Checklist3. Connection Test4. Architecture

Architecture & Flow

Interviewa is a self-hostable full-stack application built to run on your local infrastructure. It splits responsibilities into three logical blocks:

FastAPI Backend (Port 8000)

Handles interview sessions, database storage, report compilation, and connects to ChromaDB or Redis.

Next.js Frontend (Port 3000)

Implements the distraction-free interview studio workspace, text editor for coding, and dashboard reporting.

AI Inference Service (Colab/Local)

Whisper speech-to-text pipeline, text-to-speech engine, and LLM evaluators. Runs on free T4 GPU Colab notebook.