interview-os

Production-ready interview orchestration system for role kits, candidate sessions, and rubric-backed hiring recommendations.

What It Does

1. Creates reusable interview kits by role and seniority.
2. Starts candidate sessions from a selected kit.
3. Records scored responses with rubric dimensions.
4. Finalizes sessions into hiring recommendations.
5. Exposes API and dashboard views for interviewer operations and audit traces.

Stack

• Backend: FastAPI + SQLite
• Frontend: React + Vite + TypeScript
• Deployment: Docker, Docker Compose, GitHub Actions, GHCR, GitHub Pages

Dashboard Screenshot

Quick Start

cp .env.example .env
cd backend
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
pytest -q

cd ../frontend
npm install
npm run build

Run full stack:

docker compose --env-file .env -f docker-compose.yml up --build

API and Ops Docs

• docs/API.md
• docs/DEPLOYMENT.md
• docs/OPERATIONS.md
• docs/FUTURE-CLARIFICATIONS.md

Current Status

• v0.1.0 baseline: deploy-ready foundation
• Next: transcript ingestion, anti-bias controls, and calibration workflows