Requirements
Python 3.10 or newer · macOS (tested on Apple M-series) · No admin rights required
Step 1 — Download & extract
Unzip the interview_manager_v3/ folder to your preferred location:
/Users/yourname/src/gradiance/interview_manager/Step 2 — Create a virtual environment
cd /Users/yourname/src/gradiance/interview_manager
python3 -m venv venv
source venv/bin/activateStep 3 — Install dependencies
pip install matplotlib pandas certifi keyring
# Optional — only needed for audio transcription
pip install faster-whisper torchStep 4 — Launch
python3 interview_manager.pyFirst launch
A fresh interview_data.db is created automatically. You will be prompted to create a semester and class before adding students.
File structure
| File / Folder | Purpose |
|---|---|
interview_manager.py | Entry point — run this to start the app |
interview_data.db | SQLite database — all your data lives here |
settings.json | SMTP, theme, DB path, research salt |
themes/ | Custom theme JSON files |
images/ | Question images |
tests/ | 84 unit tests + 46 stress tests |
Running the tests
# Unit tests
python3 tests/test_core.py
# Stress tests (runs against a COPY of your DB)
cp interview_data.db /tmp/test.db
python3 tests/stress_test.py --db /tmp/test.db --yes-destroy-data