Skip to content
View GhostOS-ai's full-sized avatar

Block or report GhostOS-ai

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
GhostOS-ai/README.md

πŸ‘» GhostOS AI

The Featherweight, Privacy-First Desktop AI Ecosystem

PyPI version Product Hunt Platform Privacy GitHub Stars License: MIT Author: KIB.best Email


We build autonomous, featherweight, 100% offline desktop AI software engineered for modest hardware without bloat or telemetry.


🌟 Flagship Project: GhostOS

An ultra-lightweight desktop AI companion and copilot that runs smoothly on standard laptops and base Apple Silicon Macs (4GB–8GB RAM) without out-of-memory (OOM) crashes.

# One-line terminal installer (macOS & Linux)
curl -fsSL https://raw.githubusercontent.com/GhostOS-ai/GhostOS/main/install.sh | bash

# Or install via pip & launch
pip install --upgrade ghostos-ai
ghost pet

✨ Highlights

  • ⚑️ Native WebViews: Featherweight GUI idling at <35MB RAM (no Electron bloat).
  • πŸ• Casper Feeder: Interactive Drag & Drop ingestion with chewing wobble animation for source code, logs, and PDFs.
  • 🎨 Wardrobe Skins: 4 gorgeous themes for Casper (--skin glass, cyberpunk, gold, matrix).
  • πŸ‘» Native Menu Bar Tray: Zero-overhead macOS menu bar controller (ghost bar / ghost pet --tray).
  • πŸ” Instant Spotlight HUD: Floating Raycast-style offline query bar (ghost spot).
  • πŸ€– Local Model Catalog: Auto-detects Ollama models, memory footprints, and Apple Silicon Metal / CUDA acceleration (ghost models).
  • 🧠 Dynamic VRAM Juggler: Hot-swaps LLM, Vision, and Whisper in <150ms, keeping peak VRAM ≀3.5GB.
  • πŸ“‚ Zero-DB RAG: Instant file search & chat powered by pure SQLite FTS5.
  • ✍️ Ghostwriter: Inline text completion & tone rewrite across all apps via clipboard.
  • πŸ›‘ Terminal Sandbox Lens: Proactive command safety interceptor (rm -rf, DROP TABLE).
  • πŸ”’ 100% Offline & Private: Zero telemetry, air-gapped ready.

πŸ› οΈ Quick CLI Cheatsheet

Command Action
ghost pet Launch floating Casper pet & Spotlight HUD
ghost pet --skin cyberpunk --tray Launch Casper with Neon skin & Menu Bar icon
ghost spot Instant centered Spotlight HUD query bar
ghost bar Launch native macOS Menu Bar tray controller
ghost models Inspect local models & hardware acceleration
ghost "your question" Instant offline question answering
ghost eat ./notes/ Feed local documents to Zero-DB RAG
ghost write --mode polite Rewrite clipboard text in polite tone
ghost standup Generate daily standup report & git commits
ghost status Inspect live RAM/VRAM memory juggler state

🌐 Connect & Community

Crafted with passion by KIB.best β€’ Released under the MIT License

Popular repositories Loading

  1. GhostOS GhostOS Public

    πŸ‘» Lightweight, cross-platform autonomous desktop AI assistant with zero bloat and desktop integration.

    Python 4 1

  2. GhostOS-ai GhostOS-ai Public

  3. awesome-local-ai awesome-local-ai Public

    Forked from janhq/awesome-local-ai

    An awesome repository of local AI tools

  4. awesome-ai-agents awesome-ai-agents Public

    Forked from e2b-dev/awesome-ai-agents

    A list of AI autonomous agents

  5. Piktura Piktura Public

    🎨 Next-Gen Native Photoshop Alternative for macOS & Creative Pros β€’ 100% Offline β€’ Apple Silicon β€’ Zero Subscription β€’ 9 Languages

    JavaScript