ghostos-ai 1.0.0__tar.gz

ghostos_ai-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KIB.best
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ghostos_ai-1.0.0/PKG-INFO

@@ -0,0 +1,296 @@
+Metadata-Version: 2.4
+Name: ghostos-ai
+Version: 1.0.0
+Summary: The Invisible, Featherweight, Offline Desktop AI Companion & Copilot
+Home-page: https://github.com/GhostOS-ai/GhostOS
+Author: KIB.best
+Author-email: "KIB.best" <GhostOS@kib.best>
+Project-URL: Homepage, https://github.com/GhostOS-ai/GhostOS
+Project-URL: Bug Tracker, https://github.com/GhostOS-ai/GhostOS/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Desktop Environment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pywebview>=5.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: python-docx>=1.0.0
+Requires-Dist: Pillow>=10.0.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+
+<div align="center">
+
+```
+      .---.
+     /     \
+    | () () |   G H O S T O S
+     \  -  /    The Invisible, Featherweight, Offline Desktop AI Copilot
+    /`---'\
+   /       \    [ 100% Private • Dynamic VRAM Juggler • Zero-DB RAG • Casper Pet ]
+  (_/^\_/\_/^)
+```
+
+# 👻 GhostOS
+### The Featherweight, Offline AI Assistant & Desktop Companion
+
+<p align="center">
+  <b>🌐 Language Select / Выбор языка / Тілді таңдау / 语言选择:</b><br>
+  <a href="README.md"><b>English</b></a> •
+  <a href="docs/README_RU.md"><b>Русский</b></a> •
+  <a href="docs/README_KK.md"><b>Қазақша</b></a> •
+  <a href="docs/README_ZH.md"><b>简体中文</b></a> •
+  <a href="docs/README_ES.md"><b>Español</b></a> •
+  <a href="docs/README_DE.md"><b>Deutsch</b></a> •
+  <a href="docs/README_FR.md"><b>Français</b></a> •
+  <a href="docs/README_JA.md"><b>日本語</b></a> •
+  <a href="docs/README_PT.md"><b>Português</b></a>
+</p>
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Author: KIB.best](https://img.shields.io/badge/Author-KIB.best-8A2BE2.svg)](https://kib.best)
+[![Email](https://img.shields.io/badge/Contact-GhostOS%40kib.best-0071e3.svg)](mailto:GhostOS@kib.best)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-brightgreen.svg)]()
+[![Idle RAM](https://img.shields.io/badge/Idle%20RAM-%3C35%20MB-success.svg)]()
+[![Peak VRAM](https://img.shields.io/badge/Peak%20VRAM-%E2%89%A43.5%20GB-blueviolet.svg)]()
+[![Privacy](https://img.shields.io/badge/Privacy-100%25%20Offline-orange.svg)]()
+
+**A unified, ultra-lightweight desktop AI companion that runs effortlessly on low-spec laptops and base Apple Silicon Macs (4GB–8GB RAM) without Out-Of-Memory (OOM) crashes.**
+
+[Quickstart](#-quickstart) • [Features](#-exclusive-killer-features) • [Comparison](#-why-ghostos-vs-others) • [Architecture](#-architecture) • [CLI Cheatsheet](#-cli-cheatsheet) • [Privacy Pledge](#-100-paranoid-privacy-pledge)
+
+</div>
+
+---
+
+### 💡 Why GhostOS?
+
+Running local AI today is frustrating and bloated:
+- **Electron RAM Bloat:** Most local AI desktop apps (LM Studio, Jan, AnythingLLM) burn **800MB–1.2GB of RAM** on the UI alone before a single neural weight is loaded into memory.
+- **The Multi-Model OOM Trap:** Trying to run an LLM (3GB) + Vision model (2GB) + Whisper (1GB) simultaneously crashes any device with 4GB–8GB RAM.
+- **Overcomplicated RAG Stacks:** Document chat tools force users to install Docker containers, heavy vector databases (Chroma/Qdrant), and gigabytes of bloated Python dependencies.
+
+**GhostOS solves this from first principles:**
+1. **Casper Companion Pet & HUD:** Rendered via native system web engines (WebKit on macOS, Edge WebView2 on Windows, WebKitGTK on Linux) consuming just **~35MB RAM**.
+2. **Dynamic VRAM Juggler:** Dynamically hot-swaps between LLM, Vision, and Whisper on demand in <150ms. Peak VRAM never exceeds **3.5GB**.
+3. **Zero-DB RAG:** Drop files onto Casper — indexed in milliseconds using pure **SQLite FTS5** with zero external database dependencies.
+4. **100% Local & Private:** Zero telemetries, zero cloud fallbacks. Fully functional air-gapped with Wi-Fi switched off.
+
+---
+
+### ✨ Exclusive Killer Features
+
+#### 1. 👻 Casper: The Living Desktop Pet
+* A quiet, translucent porcelain ghost that floats gently over your workspace.
+* **"Casper Eats Files":** Drag & drop any PDF, code repository, notes, or spreadsheet directly onto Casper. Casper opens his mouth, swallows the file, and indexes it into your local knowledge base instantly (+15 XP!).
+* **Visual Moods & Reactive States:**
+  * 💤 `Idle`: Weightless floating animation, 0% CPU footprint.
+  * 🔮 `Thinking`: Ethereal sapphire aura, streaming local neural tokens.
+  * 🎧 `Listening`: Casper wears glowing headphones, capturing offline meetings.
+  * 🍕 `Eating`: Document suction animation with real-time XP gain.
+  * ⚠️ `Alarm`: Visual security warning when a dangerous shell command is detected.
+* Single-click for quick phrases & interactions; double-click or press `Cmd+Shift+Space` / `Ctrl+Shift+Space` to morph into the **Spotlight HUD**.
+
+#### 2. ✍️ Ghostwriter (AI Inline Completion in Any App)
+* Highlight text anywhere (Word, Telegram, browser, IDE, terminal) $\rightarrow$ press hotkey $\rightarrow$ transform instantly:
+  * ✨ `polish`: Professional, crisp, and concise rewrite.
+  * 🤝 `polite`: Diplomatic, respectful business tone.
+  * 📝 `grammar`: Fixes spelling and grammar mistakes with zero conversational fluff.
+  * 🎯 `summarize`: Distills text down to 2-3 key takeaways.
+  * 🌐 `translate`: Instant translation into English, Russian, Kazakh, Chinese, etc.
+  * 🛠️ `code_fix`: Automatically diagnoses and fixes bugs in code snippets.
+* Use from CLI: `ghost write --mode polite "draft message"` or rewrite clipboard in 1 click!
+
+#### 3. 🧠 Memory Vault (Cross-Session Context Graph)
+* Local SQLite knowledge graph that permanently stores personal context across restarts.
+* Casper automatically remembers your developer stack, favorite languages, and active projects.
+* Injects personal context into queries with **0 KB extra VRAM** and 0% background CPU footprint.
+* CLI: `ghost vault list`, `ghost vault remember tech_stack "Python, Rust, Apple Silicon"`.
+
+#### 4. 🛡️ Terminal Sandbox Lens (Destructive Command Protection)
+* Deep safety inspection for shell commands before execution.
+* Intercepts and blocks destructive operations (`rm -rf /`, `mkfs`, raw `dd`, `DROP DATABASE`, `format C:`).
+* Explains risks in plain human language and suggests safe alternatives before running.
+* Interactive audit: `ghost sandbox "rm -rf /"`.
+
+#### 5. 📅 Daily Standup & Conventional Commit Crafter
+* Analyzes daily workspace file modifications, git diffs, and session commits.
+* Generates ready-to-share Daily Standup reports for Slack / Telegram (*"What I accomplished", "What I'm working on", "Blockers"*).
+* Automatically crafts semantic Conventional Commits (`feat(...)`, `fix(...)`, `refactor(...)`).
+* CLI: `ghost standup`.
+
+#### 6. 🎙️ Auto-Minutes Meeting Copilot
+* 100% private offline secretary for Zoom, Google Meet, and voice notes.
+* Generates structured markdown meeting minutes with **Executive Overview**, **Key Decisions**, and **Action Items with Deadlines**.
+* Whisper model hot-swaps in only for the 5-second transcription window and immediately frees VRAM.
+
+#### 7. 🦎 Memory Chameleon (Adaptive Power Profiles)
+* Dynamically monitors battery state and system RAM pressure:
+  * 🍃 **ECO Mode:** Triggers on battery or RAM > 82%. Context capped at 1024 tokens, 2 CPU threads, 60s auto-sleep, 30 FPS pet.
+  * ⚖️ **Balanced Mode:** Context 2048 tokens, 4 threads, 180s auto-sleep.
+  * ⚡ **Performance Beast:** On AC power and free RAM > 50%. Context 4096 tokens, full GPU acceleration.
+
+#### 8. 🎮 Casper RPG Evolution System
+* Gamified companion that grows with your work:
+  * Gain XP for feeding files (+15 XP), running commands (+25 XP), asking questions (+10 XP).
+  * Unlocks evolutions and visual accessories (Cyberpunk Visor, Magic Spellbook, Golden Crown).
+
+---
+
+### 📊 Why GhostOS vs. Others?
+
+| Feature | GhostOS 👻 | Jan.ai / LM Studio | Ollama | AnythingLLM |
+| :--- | :---: | :---: | :---: | :---: |
+| **GUI Memory Footprint** | **~35 MB** (Native Engine) | ~850 MB (Electron) | None (CLI only) | ~1.1 GB (Electron + DB) |
+| **Desktop Pet Companion** | **Yes (Casper RPG)** | ❌ No | ❌ No | ❌ No |
+| **Drag & Drop RAG Ingestion**| **Yes (Drop onto Pet)** | ❌ Manual upload | ❌ Manual import | ❌ Manual upload |
+| **Dynamic VRAM Swapping** | **Yes (VRAM Juggler)** | ❌ OOM on low VRAM | ❌ Manual CLI | ❌ OOM on low VRAM |
+| **KV-Cache Disk Freezer** | **Yes (0 MB idle VRAM)**| ❌ No | ❌ No | ❌ No |
+| **Context Vacuum (Pruning)** | **Yes (Saves 40-60%)** | ❌ No | ❌ No | ❌ No |
+| **Adaptive Battery Profiles**| **Yes (Chameleon Mode)**| ❌ No | ❌ No | ❌ No |
+| **Inline AI Ghostwriter** | **Yes (Any desktop app)**| ❌ No | ❌ No | ❌ No |
+| **Terminal Sandbox Lens** | **Yes (Safety protection)**| ❌ No | ❌ No | ❌ No |
+| **Daily Standup / Commit Crafter**| **Yes (Built-in)** | ❌ No | ❌ No | ❌ No |
+| **External DB Requirement** | **Zero (SQLite FTS5)** | Varies | None | Requires Vector DB / Chroma |
+| **Cross-Platform (macOS/Win/Linux)** | **Yes** | Yes | Yes | Yes |
+| **Works 100% Offline** | **Yes** | Yes | Yes | Mostly |
+
+---
+
+### 🚀 Quickstart
+
+#### 1. Clone & Install
+```bash
+git clone https://github.com/GhostOS-ai/GhostOS.git
+cd GhostOS
+pip install -e .
+```
+
+#### 2. Launch Casper Desktop Pet & HUD
+```bash
+ghost pet
+```
+*Casper will float on your desktop. Drag any file onto him, or click him to open the HUD!*
+
+#### 3. Or use directly from Terminal (CLI)
+```bash
+# Instant question with zero setup
+ghost "Why does Python raise RecursionError and how to fix it?"
+
+# Feed a document or source directory to Casper (Zero-DB RAG)
+ghost eat ~/Documents/my_notes.txt
+ghost eat ./src/
+
+# Inline AI Ghostwriter (rewrites clipboard or given text)
+ghost write --mode polite "can you fix this asap"
+ghost write --mode grammar
+
+# Long-term Memory Vault
+ghost vault remember tech_stack "Python, Rust, Apple Silicon"
+ghost vault list
+
+# Daily Standup Report & Semantic Commit Crafter
+ghost standup
+
+# Terminal Sandbox Safety Lens
+ghost sandbox "rm -rf /"
+
+# Search indexed knowledge
+ghost rag search "database migration"
+
+# Inspect current active screen
+ghost screen
+
+# Generate and safely run a terminal task
+ghost exec "find all files larger than 100MB"
+
+# Check VRAM Juggler memory diagnostics
+ghost status
+```
+
+---
+
+### ⌨️ Keyboard Shortcuts
+
+| Shortcut | Action |
+| :--- | :--- |
+| `Cmd + Shift + Space` / `Ctrl + Shift + Space` | Toggle Spotlight HUD |
+| `Click Ghost` | Talk with Casper / Pet reaction |
+| `Double Click Ghost` | Open Quick Command HUD |
+| `Escape` | Minimize back to Floating Casper |
+| `Enter` | Submit query |
+| `Drag & Drop File` | Feed document to Casper (Instant RAG) |
+
+---
+
+### 🏗️ Architecture
+
+```mermaid
+flowchart TD
+    User([User Desktop]) -->|Drag & Drop File / Click| Pet["👻 Casper Floating Pet (Native Engine)"]
+    User -->|Hotkey Cmd+Shift+Space| HUD["🔮 Spotlight HUD / Command Bar"]
+    User -->|Terminal CLI| CLI["💻 ghost CLI (rich)"]
+
+    Pet --> Bridge["Python <-> JS Bridge API"]
+    HUD --> Bridge
+    CLI --> Core["GhostOS Core Engine"]
+    Bridge --> Core
+
+    subgraph MemoryManagement ["🧠 VRAM Juggler & Memory Chameleon"]
+        Core --> Juggler["Memory Juggler Dispatcher"]
+        Juggler -->|Hot-Swap <= 3.5GB| M1["Qwen 2.5 / Llama 3.2 (LLM)"]
+        Juggler -->|Hot-Swap <= 2.0GB| M2["Moondream2 / MiniCPM (Vision)"]
+        Juggler -->|Hot-Swap <= 0.6GB| M3["Whisper (Voice Copilot)"]
+    end
+
+    subgraph Storage ["📂 Zero-DB Storage & Vault"]
+        Core --> RAG["SQLite FTS5 Knowledge Base"]
+        Core --> Vault["🧠 Memory Vault (Long-Term Facts)"]
+        RAG --> Docs[("Local Notes / Code / PDFs")]
+    end
+
+    subgraph OSIntegration ["⚡ System Integration"]
+        Core --> Screen["Silent Screen Inspector"]
+        Core --> Pilot["Safe Terminal Autopilot"]
+        Core --> Lens["🛡️ Sandbox Lens"]
+        Core --> Writer["✍️ Ghostwriter Engine"]
+    end
+```
+
+---
+
+### 🔒 100% Paranoid Privacy Pledge
+
+GhostOS is engineered with privacy as a foundational constraint:
+- **Zero Telemetry:** No analytics, no phone-home pings, no user tracking.
+- **Zero Cloud Fallbacks:** Every neural calculation runs locally on your device's CPU/GPU.
+- **Air-Gapped Ready:** Works with your Wi-Fi completely disabled.
+
+---
+
+### 🤝 Contributing
+
+Contributions are warmly welcomed! Feel free to submit issues, pull requests, or custom Casper skins.
+
+```bash
+# Run full unit test suite (44+ tests)
+python3 -m unittest discover tests
+```
+
+---
+
+### 📄 License & Authorship
+
+- **Author:** [KIB.best](https://kib.best)
+- **Email:** [GhostOS@kib.best](mailto:GhostOS@kib.best)
+- **License:** MIT License © 2026 KIB.best. Free for personal and commercial use.

ghostos_ai-1.0.0/README.md

@@ -0,0 +1,266 @@
+<div align="center">
+
+```
+      .---.
+     /     \
+    | () () |   G H O S T O S
+     \  -  /    The Invisible, Featherweight, Offline Desktop AI Copilot
+    /`---'\
+   /       \    [ 100% Private • Dynamic VRAM Juggler • Zero-DB RAG • Casper Pet ]
+  (_/^\_/\_/^)
+```
+
+# 👻 GhostOS
+### The Featherweight, Offline AI Assistant & Desktop Companion
+
+<p align="center">
+  <b>🌐 Language Select / Выбор языка / Тілді таңдау / 语言选择:</b><br>
+  <a href="README.md"><b>English</b></a> •
+  <a href="docs/README_RU.md"><b>Русский</b></a> •
+  <a href="docs/README_KK.md"><b>Қазақша</b></a> •
+  <a href="docs/README_ZH.md"><b>简体中文</b></a> •
+  <a href="docs/README_ES.md"><b>Español</b></a> •
+  <a href="docs/README_DE.md"><b>Deutsch</b></a> •
+  <a href="docs/README_FR.md"><b>Français</b></a> •
+  <a href="docs/README_JA.md"><b>日本語</b></a> •
+  <a href="docs/README_PT.md"><b>Português</b></a>
+</p>
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Author: KIB.best](https://img.shields.io/badge/Author-KIB.best-8A2BE2.svg)](https://kib.best)
+[![Email](https://img.shields.io/badge/Contact-GhostOS%40kib.best-0071e3.svg)](mailto:GhostOS@kib.best)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-brightgreen.svg)]()
+[![Idle RAM](https://img.shields.io/badge/Idle%20RAM-%3C35%20MB-success.svg)]()
+[![Peak VRAM](https://img.shields.io/badge/Peak%20VRAM-%E2%89%A43.5%20GB-blueviolet.svg)]()
+[![Privacy](https://img.shields.io/badge/Privacy-100%25%20Offline-orange.svg)]()
+
+**A unified, ultra-lightweight desktop AI companion that runs effortlessly on low-spec laptops and base Apple Silicon Macs (4GB–8GB RAM) without Out-Of-Memory (OOM) crashes.**
+
+[Quickstart](#-quickstart) • [Features](#-exclusive-killer-features) • [Comparison](#-why-ghostos-vs-others) • [Architecture](#-architecture) • [CLI Cheatsheet](#-cli-cheatsheet) • [Privacy Pledge](#-100-paranoid-privacy-pledge)
+
+</div>
+
+---
+
+### 💡 Why GhostOS?
+
+Running local AI today is frustrating and bloated:
+- **Electron RAM Bloat:** Most local AI desktop apps (LM Studio, Jan, AnythingLLM) burn **800MB–1.2GB of RAM** on the UI alone before a single neural weight is loaded into memory.
+- **The Multi-Model OOM Trap:** Trying to run an LLM (3GB) + Vision model (2GB) + Whisper (1GB) simultaneously crashes any device with 4GB–8GB RAM.
+- **Overcomplicated RAG Stacks:** Document chat tools force users to install Docker containers, heavy vector databases (Chroma/Qdrant), and gigabytes of bloated Python dependencies.
+
+**GhostOS solves this from first principles:**
+1. **Casper Companion Pet & HUD:** Rendered via native system web engines (WebKit on macOS, Edge WebView2 on Windows, WebKitGTK on Linux) consuming just **~35MB RAM**.
+2. **Dynamic VRAM Juggler:** Dynamically hot-swaps between LLM, Vision, and Whisper on demand in <150ms. Peak VRAM never exceeds **3.5GB**.
+3. **Zero-DB RAG:** Drop files onto Casper — indexed in milliseconds using pure **SQLite FTS5** with zero external database dependencies.
+4. **100% Local & Private:** Zero telemetries, zero cloud fallbacks. Fully functional air-gapped with Wi-Fi switched off.
+
+---
+
+### ✨ Exclusive Killer Features
+
+#### 1. 👻 Casper: The Living Desktop Pet
+* A quiet, translucent porcelain ghost that floats gently over your workspace.
+* **"Casper Eats Files":** Drag & drop any PDF, code repository, notes, or spreadsheet directly onto Casper. Casper opens his mouth, swallows the file, and indexes it into your local knowledge base instantly (+15 XP!).
+* **Visual Moods & Reactive States:**
+  * 💤 `Idle`: Weightless floating animation, 0% CPU footprint.
+  * 🔮 `Thinking`: Ethereal sapphire aura, streaming local neural tokens.
+  * 🎧 `Listening`: Casper wears glowing headphones, capturing offline meetings.
+  * 🍕 `Eating`: Document suction animation with real-time XP gain.
+  * ⚠️ `Alarm`: Visual security warning when a dangerous shell command is detected.
+* Single-click for quick phrases & interactions; double-click or press `Cmd+Shift+Space` / `Ctrl+Shift+Space` to morph into the **Spotlight HUD**.
+
+#### 2. ✍️ Ghostwriter (AI Inline Completion in Any App)
+* Highlight text anywhere (Word, Telegram, browser, IDE, terminal) $\rightarrow$ press hotkey $\rightarrow$ transform instantly:
+  * ✨ `polish`: Professional, crisp, and concise rewrite.
+  * 🤝 `polite`: Diplomatic, respectful business tone.
+  * 📝 `grammar`: Fixes spelling and grammar mistakes with zero conversational fluff.
+  * 🎯 `summarize`: Distills text down to 2-3 key takeaways.
+  * 🌐 `translate`: Instant translation into English, Russian, Kazakh, Chinese, etc.
+  * 🛠️ `code_fix`: Automatically diagnoses and fixes bugs in code snippets.
+* Use from CLI: `ghost write --mode polite "draft message"` or rewrite clipboard in 1 click!
+
+#### 3. 🧠 Memory Vault (Cross-Session Context Graph)
+* Local SQLite knowledge graph that permanently stores personal context across restarts.
+* Casper automatically remembers your developer stack, favorite languages, and active projects.
+* Injects personal context into queries with **0 KB extra VRAM** and 0% background CPU footprint.
+* CLI: `ghost vault list`, `ghost vault remember tech_stack "Python, Rust, Apple Silicon"`.
+
+#### 4. 🛡️ Terminal Sandbox Lens (Destructive Command Protection)
+* Deep safety inspection for shell commands before execution.
+* Intercepts and blocks destructive operations (`rm -rf /`, `mkfs`, raw `dd`, `DROP DATABASE`, `format C:`).
+* Explains risks in plain human language and suggests safe alternatives before running.
+* Interactive audit: `ghost sandbox "rm -rf /"`.
+
+#### 5. 📅 Daily Standup & Conventional Commit Crafter
+* Analyzes daily workspace file modifications, git diffs, and session commits.
+* Generates ready-to-share Daily Standup reports for Slack / Telegram (*"What I accomplished", "What I'm working on", "Blockers"*).
+* Automatically crafts semantic Conventional Commits (`feat(...)`, `fix(...)`, `refactor(...)`).
+* CLI: `ghost standup`.
+
+#### 6. 🎙️ Auto-Minutes Meeting Copilot
+* 100% private offline secretary for Zoom, Google Meet, and voice notes.
+* Generates structured markdown meeting minutes with **Executive Overview**, **Key Decisions**, and **Action Items with Deadlines**.
+* Whisper model hot-swaps in only for the 5-second transcription window and immediately frees VRAM.
+
+#### 7. 🦎 Memory Chameleon (Adaptive Power Profiles)
+* Dynamically monitors battery state and system RAM pressure:
+  * 🍃 **ECO Mode:** Triggers on battery or RAM > 82%. Context capped at 1024 tokens, 2 CPU threads, 60s auto-sleep, 30 FPS pet.
+  * ⚖️ **Balanced Mode:** Context 2048 tokens, 4 threads, 180s auto-sleep.
+  * ⚡ **Performance Beast:** On AC power and free RAM > 50%. Context 4096 tokens, full GPU acceleration.
+
+#### 8. 🎮 Casper RPG Evolution System
+* Gamified companion that grows with your work:
+  * Gain XP for feeding files (+15 XP), running commands (+25 XP), asking questions (+10 XP).
+  * Unlocks evolutions and visual accessories (Cyberpunk Visor, Magic Spellbook, Golden Crown).
+
+---
+
+### 📊 Why GhostOS vs. Others?
+
+| Feature | GhostOS 👻 | Jan.ai / LM Studio | Ollama | AnythingLLM |
+| :--- | :---: | :---: | :---: | :---: |
+| **GUI Memory Footprint** | **~35 MB** (Native Engine) | ~850 MB (Electron) | None (CLI only) | ~1.1 GB (Electron + DB) |
+| **Desktop Pet Companion** | **Yes (Casper RPG)** | ❌ No | ❌ No | ❌ No |
+| **Drag & Drop RAG Ingestion**| **Yes (Drop onto Pet)** | ❌ Manual upload | ❌ Manual import | ❌ Manual upload |
+| **Dynamic VRAM Swapping** | **Yes (VRAM Juggler)** | ❌ OOM on low VRAM | ❌ Manual CLI | ❌ OOM on low VRAM |
+| **KV-Cache Disk Freezer** | **Yes (0 MB idle VRAM)**| ❌ No | ❌ No | ❌ No |
+| **Context Vacuum (Pruning)** | **Yes (Saves 40-60%)** | ❌ No | ❌ No | ❌ No |
+| **Adaptive Battery Profiles**| **Yes (Chameleon Mode)**| ❌ No | ❌ No | ❌ No |
+| **Inline AI Ghostwriter** | **Yes (Any desktop app)**| ❌ No | ❌ No | ❌ No |
+| **Terminal Sandbox Lens** | **Yes (Safety protection)**| ❌ No | ❌ No | ❌ No |
+| **Daily Standup / Commit Crafter**| **Yes (Built-in)** | ❌ No | ❌ No | ❌ No |
+| **External DB Requirement** | **Zero (SQLite FTS5)** | Varies | None | Requires Vector DB / Chroma |
+| **Cross-Platform (macOS/Win/Linux)** | **Yes** | Yes | Yes | Yes |
+| **Works 100% Offline** | **Yes** | Yes | Yes | Mostly |
+
+---
+
+### 🚀 Quickstart
+
+#### 1. Clone & Install
+```bash
+git clone https://github.com/GhostOS-ai/GhostOS.git
+cd GhostOS
+pip install -e .
+```
+
+#### 2. Launch Casper Desktop Pet & HUD
+```bash
+ghost pet
+```
+*Casper will float on your desktop. Drag any file onto him, or click him to open the HUD!*
+
+#### 3. Or use directly from Terminal (CLI)
+```bash
+# Instant question with zero setup
+ghost "Why does Python raise RecursionError and how to fix it?"
+
+# Feed a document or source directory to Casper (Zero-DB RAG)
+ghost eat ~/Documents/my_notes.txt
+ghost eat ./src/
+
+# Inline AI Ghostwriter (rewrites clipboard or given text)
+ghost write --mode polite "can you fix this asap"
+ghost write --mode grammar
+
+# Long-term Memory Vault
+ghost vault remember tech_stack "Python, Rust, Apple Silicon"
+ghost vault list
+
+# Daily Standup Report & Semantic Commit Crafter
+ghost standup
+
+# Terminal Sandbox Safety Lens
+ghost sandbox "rm -rf /"
+
+# Search indexed knowledge
+ghost rag search "database migration"
+
+# Inspect current active screen
+ghost screen
+
+# Generate and safely run a terminal task
+ghost exec "find all files larger than 100MB"
+
+# Check VRAM Juggler memory diagnostics
+ghost status
+```
+
+---
+
+### ⌨️ Keyboard Shortcuts
+
+| Shortcut | Action |
+| :--- | :--- |
+| `Cmd + Shift + Space` / `Ctrl + Shift + Space` | Toggle Spotlight HUD |
+| `Click Ghost` | Talk with Casper / Pet reaction |
+| `Double Click Ghost` | Open Quick Command HUD |
+| `Escape` | Minimize back to Floating Casper |
+| `Enter` | Submit query |
+| `Drag & Drop File` | Feed document to Casper (Instant RAG) |
+
+---
+
+### 🏗️ Architecture
+
+```mermaid
+flowchart TD
+    User([User Desktop]) -->|Drag & Drop File / Click| Pet["👻 Casper Floating Pet (Native Engine)"]
+    User -->|Hotkey Cmd+Shift+Space| HUD["🔮 Spotlight HUD / Command Bar"]
+    User -->|Terminal CLI| CLI["💻 ghost CLI (rich)"]
+
+    Pet --> Bridge["Python <-> JS Bridge API"]
+    HUD --> Bridge
+    CLI --> Core["GhostOS Core Engine"]
+    Bridge --> Core
+
+    subgraph MemoryManagement ["🧠 VRAM Juggler & Memory Chameleon"]
+        Core --> Juggler["Memory Juggler Dispatcher"]
+        Juggler -->|Hot-Swap <= 3.5GB| M1["Qwen 2.5 / Llama 3.2 (LLM)"]
+        Juggler -->|Hot-Swap <= 2.0GB| M2["Moondream2 / MiniCPM (Vision)"]
+        Juggler -->|Hot-Swap <= 0.6GB| M3["Whisper (Voice Copilot)"]
+    end
+
+    subgraph Storage ["📂 Zero-DB Storage & Vault"]
+        Core --> RAG["SQLite FTS5 Knowledge Base"]
+        Core --> Vault["🧠 Memory Vault (Long-Term Facts)"]
+        RAG --> Docs[("Local Notes / Code / PDFs")]
+    end
+
+    subgraph OSIntegration ["⚡ System Integration"]
+        Core --> Screen["Silent Screen Inspector"]
+        Core --> Pilot["Safe Terminal Autopilot"]
+        Core --> Lens["🛡️ Sandbox Lens"]
+        Core --> Writer["✍️ Ghostwriter Engine"]
+    end
+```
+
+---
+
+### 🔒 100% Paranoid Privacy Pledge
+
+GhostOS is engineered with privacy as a foundational constraint:
+- **Zero Telemetry:** No analytics, no phone-home pings, no user tracking.
+- **Zero Cloud Fallbacks:** Every neural calculation runs locally on your device's CPU/GPU.
+- **Air-Gapped Ready:** Works with your Wi-Fi completely disabled.
+
+---
+
+### 🤝 Contributing
+
+Contributions are warmly welcomed! Feel free to submit issues, pull requests, or custom Casper skins.
+
+```bash
+# Run full unit test suite (44+ tests)
+python3 -m unittest discover tests
+```
+
+---
+
+### 📄 License & Authorship
+
+- **Author:** [KIB.best](https://kib.best)
+- **Email:** [GhostOS@kib.best](mailto:GhostOS@kib.best)
+- **License:** MIT License © 2026 KIB.best. Free for personal and commercial use.

ghostos_ai-1.0.0/ghost/__init__.py

@@ -0,0 +1,6 @@
+"""
+GhostOS: The Invisible, Featherweight, Offline Desktop AI Companion & Copilot.
+"""
+__version__ = "1.0.0"
+__author__ = "KIB.best"
+__email__ = "GhostOS@kib.best"

ghostos_ai-1.0.0/ghost/__main__.py

@@ -0,0 +1,7 @@
+"""
+Entry point for python -m ghost
+"""
+from ghost.cli.main import main
+
+if __name__ == "__main__":
+    main()

ghostos_ai-1.0.0/ghost/config.py

@@ -0,0 +1,57 @@
+"""
+GhostOS Configuration & Path Management
+"""
+import os
+import json
+from pathlib import Path
+from typing import Dict, Any
+
+# Root data directory in user home
+GHOST_HOME = Path.home() / ".ghostos"
+GHOST_MODELS_DIR = GHOST_HOME / "models"
+GHOST_CACHE_DIR = GHOST_HOME / "cache"
+GHOST_RECORDINGS_DIR = GHOST_HOME / "recordings"
+GHOST_DB_PATH = GHOST_HOME / "ghost_knowledge.db"
+CONFIG_FILE = GHOST_HOME / "config.json"
+
+DEFAULT_CONFIG: Dict[str, Any] = {
+    "engine": "auto",           # "auto", "ollama", "llamacpp", "mock"
+    "model_name": "qwen2.5-3b-q4",
+    "vram_limit_mb": 4096,     # Target VRAM ceiling (4GB)
+    "auto_sleep_seconds": 180, # Unload inactive models after 3 minutes
+    "pet_mode": "floating",    # "floating", "stealth", "docked"
+    "hotkey": "Cmd+Shift+Space",
+    "sound_effects": True,
+    "theme": "dark_neon",
+    "ollama_host": "http://localhost:11434",
+    "safe_terminal_mode": True,
+}
+
+def ensure_dirs() -> None:
+    """Ensure all required directories exist."""
+    GHOST_HOME.mkdir(parents=True, exist_ok=True)
+    GHOST_MODELS_DIR.mkdir(parents=True, exist_ok=True)
+    GHOST_CACHE_DIR.mkdir(parents=True, exist_ok=True)
+    GHOST_RECORDINGS_DIR.mkdir(parents=True, exist_ok=True)
+    if not CONFIG_FILE.exists():
+        save_config(DEFAULT_CONFIG)
+
+def load_config() -> Dict[str, Any]:
+    """Load configuration from disk, falling back to defaults."""
+    ensure_dirs()
+    if CONFIG_FILE.exists():
+        try:
+            with open(CONFIG_FILE, "r", encoding="utf-8") as f:
+                data = json.load(f)
+                merged = DEFAULT_CONFIG.copy()
+                merged.update(data)
+                return merged
+        except Exception:
+            return DEFAULT_CONFIG.copy()
+    return DEFAULT_CONFIG.copy()
+
+def save_config(cfg: Dict[str, Any]) -> None:
+    """Save configuration to disk."""
+    GHOST_HOME.mkdir(parents=True, exist_ok=True)
+    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+        json.dump(cfg, f, indent=2, ensure_ascii=False)