README

SmartInterview

Copilota AI locale per colloqui tecnici su Windows.

SmartInterview cattura l'audio di sistema (e opzionalmente il microfono), lo trascrive in locale con Whisper, e genera risposte in streaming da un modello Qwen2.5 (GGUF) — tutto senza API cloud durante il colloquio.

Documentazione

Struttura repository

SmartInterview_Delphi/
????????? Projects.groupproj              # Group project (SmartInterview + LicenseManager)
????????? Projects/
???   ????????? SmartInterview/             # Applicazione principale
???   ???   ????????? SmartInterview.dpr/.dproj
???   ???   ????????? uMainForm.*             # Overlay colloquio
???   ???   ????????? uFrm*.pas               # Form (licenza, splash, settings, ???)
???   ???   ????????? src/                    # Unit?? Delphi (audio, bridge engine, settings)
???   ????????? LicenseManager/             # Tool generazione licenze (genera anche le chiavi di firma)
???   ????????? Engine/                     # Motore C# (.NET 10)
???       ????????? Program.cs              # Entry point JSON stdin/stdout
???       ????????? SmartInterview.Engine.csproj
???       ????????? *.cs
????????? Common/                         # Unit?? Pascal condivise (es. uLicenseCodec)
????????? docs/                           # Documentazione dettagliata
????????? README.md                       # Questo file

Come funziona (in breve)

flowchart TB
  subgraph Delphi["SmartInterview.exe (Delphi)"]
    UI[uMainForm]
    Pipe[uPipeEngine]
    Lic[uLicenseService]
    UI --> Pipe
    Lic -->|token + env vars| Pipe
  end
  subgraph Host["Processo figlio dotnet"]
    DLL[SmartInterview.Engine.dll]
    Auth[EngineSessionAuth]
    Auth -->|gate licenza| DLL
  end
  Pipe -->|CreateProcess + pipe| Host
  Pipe <-->|JSON stdin/stdout| DLL
  UI --> Audio[WASAPI 16 kHz]

1. Avvio — verifica licenza, disclaimer, splash con download/caricamento modelli.
2. Motore — uPipeEngine avvia dotnet SmartInterview.Engine.dll dalla cartella EngineDeploy\, passando token di sessione e chiave licenza via variabili d'ambiente.
3. Ascolto — manuale (tieni Ctrl/Shift/Alt) o automatico (VAD su audio di sistema).
4. Trascrizione — PCM inviato al motore via IPC transcribe / transcribe_stream.
5. Risposta — LLM locale in streaming (generate_stream); in modalità auto, classify_utterance filtra le non-domande.

Il motore rifiuta tutti i comandi AI senza autenticazione licenza valida. Dettagli in Architettura → Gate licenza.

Modelli AI

I modelli non sono nel repository. Al primo avvio vengono scaricati in <exe>\models o %LOCALAPPDATA%\SmartInterview\models.

Motore di trascrizione: Whisper (Whisper.net), con la lingua del colloquio forzata — l'utente sceglie es. italiano e la trascrizione resta in italiano, senza scivolare in russo/inglese. Gira su GPU (CUDA→Vulkan→CPU): su una RTX 50xx via Vulkan anche large-v3 è rapido. Verificato 10/10 su voce reale italiana con termini tecnici inglesi ("Sai cos'è Unity?"). In alternativa, Parakeet TDT 0.6B v3 (sherpa-onnx, CPU, multilingue auto) è disponibile come opzione via SMARTINTERVIEW_USE_PARAKEET=1 — più veloce su CPU ma senza lingua forzata (rilevamento automatico), quindi sconsigliato quando serve una lingua fissa.

Il tier viene scelto in base alla GPU/VRAM rilevata (HardwareProbe + impostazioni utente).

Backend GPU

Build rapida

Requisiti: RAD Studio 12+ (Delphi Win64), .NET SDK 10, Windows x64.

1. Apri Projects.groupproj in RAD Studio.
2. Compila SmartInterview (Win64).
3. La build Delphi esegue automaticamente dotnet build sull'engine e deploya l'output in Projects/SmartInterview/Win64/<Config>/EngineDeploy/.

Build manuale engine:

dotnet build Projects\Engine\SmartInterview.Engine.csproj -c Release

Guida completa: docs/setup.md.

Progetti Delphi

Entrambi risolvono le unità condivise da Common/ (search path ..\..\Common\).

Impostazioni utente

Salvate nel registry HKCU\Software\SmartInterview (uRegistryStore.pas):

• Lingua (default en)
• Tier modelli LLM e Whisper
• Lunghezza risposta (breve/medio/lungo)
• Tasto ascolto (Ctrl/Shift/Alt)
• Opacità overlay
• Profilo colloquio (ruolo, stack, job, esperienza)
• Parametri VAD (soglia, silenzio)

Note per manutentori

• Discovery motore: uPipeEngine.FindEngineDll cerca SmartInterview.Engine.dll in EngineDeploy\ accanto a SmartInterview.exe.
• Avvio motore: CreateProcess con comando dotnet "<path>\SmartInterview.Engine.dll" e pipe stdin/stdout per IPC JSON-lines.
• Gate licenza: variabili SMARTINTERVIEW_SESSION, SMARTINTERVIEW_LICENSE, SMARTINTERVIEW_USER + validazione in EngineSessionAuth.cs.
• Memoria conversazione: RAM in LocalLlmClient.cs; baseline tokens esclusi dalla % contesto UI.
• Manuale vs auto: la cattura manuale risponde sempre; l'auto usa classify_utterance + marker [[SKIP]].
• Nuovo comando IPC: handler in Projects/Engine/Program.cs → wrapper uPipeEngine.pas → caller uMainForm.pas.
• Unità condivise: mettere in Common/, non duplicare tra progetti.
• Diagnostica trascrizione: %LOCALAPPDATA%\SmartInterview\live-transcribe-diag.log.

Licenza software

SmartInterview richiede una chiave licenza valida all'avvio (formato v5 SI5-…, firmata ECDSA). Per generare chiavi usare LicenseManager (tool interno).

• Guida semplice sicurezza: docs/sicurezza-guida.md — internet, scadenza, controllo con app aperta
• Dettaglio tecnico: docs/licensing.md