Skip to content

v0.1.1

Choose a tag to compare

@fakhruldeen fakhruldeen released this 16 Oct 19:12
· 13 commits to main since this release

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_HERE Readiness: Models progress through SUPPORTED ➔ 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 retains DOWNLOADED_PREPARED without 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 GPU mode 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, and llama.cpp) rather than routing everything through llama.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_exists to 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


📦 Installation & Upgrade

Upgrade via Pip:

pip install --upgrade localpilot


**Full Changelog**: https://github.com/fakhruldeen/LocalPilot/compare/v0.1.0...v0.1.1