Skip to content

v0.1.0

Choose a tag to compare

@fakhruldeen fakhruldeen released this 16 Oct 16:28
· 17 commits to main since this release

LocalPilot v0.1.0 — Local AI, Made Simple

LocalPilot is a friendly Python application that helps nontechnical users discover, install, run, monitor, update, and remove local AI models safely on their computers without technical guesswork.

🌟 Key Highlights in v0.1.0

  • 🧠 Hardware-Aware Recommendation: Evaluates CPU, RAM, Apple Silicon Unified Memory vs. discrete Linux/Intel GPUs, and disk budgets to filter out incompatible models before downloading.
  • 🧭 3-Axis Execution Architecture:
    • Inference Backends: llama.cpp (GGUF, Apple Metal, NVIDIA CUDA, ROCm) and vLLM (advanced Linux+GPU).
    • Managed Execution Services: Ollama, LM Studio / llmster (unified desktop app, headless daemon, and CLI), and Docker Model Runner.
    • Deployment Methods: Direct isolated worker processes (direct_worker), local API services (local_api_service), and containers (container).
  • 🛡️ External Service & Data Protection:
    • Unloads model weights from memory (keep_alive=0 / /v1/models/unload) without terminating shared background daemons.
    • Reference-counted storage ensures shared weights are protected and non-owned files are never deleted.
  • 📦 Multi-Scope Installation: Install supporting runtimes into Application-Isolated (isolated, default), User Space (~/.local/bin), or System Wide (/usr/local/bin).
  • 💻 Dual Interface:
    • Full-screen interactive dashboard powered by Textual (localpilot).
    • Scriptable, fast command line powered by Typer and Rich (localpilot doctor, localpilot discover, localpilot setup).
  • 📝 Comprehensive Observability: Structured event logs, audit checkpoints before destructive state changes, and redacting support bundles.

⚠️ Disclaimer & Notice

Personal Use & Testing Only: LocalPilot is intended for non-professional and hobbyist exploration. Local model execution involves fast-moving, cutting-edge technologies that typically require specialized knowledge and ongoing training to configure and operate reliably.

This project is provided strictly on an "AS-IS" basis for personal evaluation, experimentation, and research purposes. It is NOT designed, validated, or certified for production environments, mission-critical infrastructure, or commercial deployments. The creator and maintainer assume no liabilities, warranties, or legal responsibilities whatsoever for any data loss, system instability, hardware stress, service disruptions, or issues arising from the use or misuse of this software in production or any other context.


📦 Installation

# Via pipx (recommended)
pipx install localpilot

# Via pip
pip install localpilot

# Or standalone curl installer
curl -fsSL https://raw.githubusercontent.com/fakhruldeen/LocalPilot/main/install-localpilot.sh | bash

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