Repository navigation
v0.1.1
LocalPilot v0.1.1: Architecture Remediation, Evidence-Based Verification & TUI Polish
LocalPilot v0.1.1 resolves key findings from our architectural review, replacing placeholders with evidence-based verification, strict hardware and execution mode enforcement, safe external service protection, and a more responsive terminal UI.
🛡️ Critical Fixes & Remediation
- No Synthetic File Placeholders: Removed synthetic model weight generation (
b"GGUF\x03\x00...") from production paths. Missing files now cleanly raise descriptive errors and strictly require real downloads or existing local models. - Evidence-Based
TESTED_HEREReadiness: Models progress throughSUPPORTED➔EXPECTED_TO_FIT➔DOWNLOADED_PREPARED➔TESTED_HERE. The final readiness state is awarded only after live test inference passes. If loading or test inference fails, the installation retainsDOWNLOADED_PREPAREDwithout deleting the downloaded files. - Verified Updates & Safe Rollback: Replaced hardcoded update checks with dynamic release querying. Updates create an atomic backup of model weights before applying changes, automatically restoring previous versions if verification fails.
- Strict Execution Mode Enforcement: Explicit
GPUmode requests reject configurations lacking dedicated graphics or sufficient VRAM (GPU_NOT_AVAILABLE/INSUFFICIENT_VRAM) rather than silently falling back to CPU execution. - Strict 3-Axis Backend Dispatch: Model setup dynamically routes to the selected backend and service adapters (
vLLM,Ollama,LM Studio,Docker Model Runner, andllama.cpp) rather than routing everything throughllama.cpp. - Ollama Ownership & Extraction Safety: Fixed external endpoint probing to avoid assigning LocalPilot's own PID; added asynchronous polling with child crash detection during startup; and added safe zip extraction (
safe_extract_zip) for macOS release archives. - Process Reconciliation: The TUI and CLI reconcile database rows against live OS processes using
psutil.pid_existsto detect active vs. stale instances. - Model Removal Protection: Blocks model deletion if an instance of that model is currently running or if an active workflow job is in progress.
⚡ UX & Performance Improvements
- TUI Debouncing: Added a 350ms debounce to the search input to keep the discovery dashboard fluid and responsive.
- Background Hardware Probes: Moved system health inspection into an asynchronous worker thread (
thread=True) to eliminate any initial interface blocking. - Quick Action Keybindings: Added direct action shortcuts in the TUI:
- Enter to launch model setup
- x to stop running instances
- Delete to remove installed models
🧪 Test Verification
- 43 / 43 tests passing across the complete test suite.
- Added
tests/test_remediation_p0_p1.pywith 7 regression tests verifying the remediation items.
📦 Installation & Upgrade
Upgrade via Pip:
pip install --upgrade localpilot
**Full Changelog**: https://github.com/fakhruldeen/LocalPilot/compare/v0.1.0...v0.1.1