ji

README.md

@@ -89,6 +89,33 @@ Push-to-talk: `Ctrl+Space` in the window, `Ctrl+Alt+Space` system-wide (Windows)
 3. Javis will VAD-split, transcribe, and build a clean dataset.
 4. Test with zero-shot cloning (instant) or click **Fine-tune** for higher quality.
 
+Fine-tuning runs in a console window of its own. Meanwhile Javis speaks with the
+voice being trained, refreshed with the training progress every 15 minutes. Stop it
+any time — Ctrl+C, closing the window, logging off or shutting down saves the
+epoch so far, and the next run continues with its next batch. A crash loses at most
+the last 10 minutes (`JAVIS_PIPER_PROGRESS_MINUTES`); training restarts by itself.
+
+## Speaker identification
+
+With `speaker_id.enabled`, Javis recognises who is talking (ECAPA embeddings) and manages
+speakers in **Intelligence → Voice Profiles**:
+
+- **Enroll** — `+` records a few sentences and creates a profile.
+- **Unidentified speakers** — utterances that matched no profile are kept (audio,
+  transcript, time, source device, closest profile). **▶ Play** listens to one;
+  **Sort…** adds it to an existing profile or creates a new one. Recordings that sound
+  alike are offered and pre-selected so you can sort several at once. ✕ / **Clear all**
+  delete them.
+- **Enhance a voice** — 🎤 on a profile card opens a recorder: click **● Record sample**,
+  speak, review each sample (playback + how well it matches the profile; mismatches are
+  flagged), then **Add N samples** to blend them in.
+- The "unknown speaker" pop-up (`speaker_id.auto_enroll`) can also play back what was said.
+
+Unknown-speaker clips are stored locally only, in `<voice_profiles_dir>/unidentified/`.
+They are capped by `speaker_id.max_unidentified` (default 50, oldest dropped first). Turn
+the inbox off with `speaker_id.keep_unidentified: false`. Both settings are under
+**Settings → Speaker Identification**.
+
 ## MCP servers
 
 Edit `mcp_servers.json`. Schema matches VS Code's `mcp.json`, so you can copy/paste server entries.