Agentic Linux Assistant

The "Cursor" for operating systems. A system-native AI assistant with modern glassmorphism UI and natural language system control, featuring real-time LLM streaming and secure sudo authentication.

Quick Start

1. Install Dependencies

# System packages for Qt6 (Primary)
sudo apt update
sudo apt install python3-pyside6.qtwidgets python3-pyside6.qtcore python3-pyside6.qtgui wmctrl xdotool

# System packages for GTK4 (Fallback)
sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-4.0 gir1.2-adw-1 libgtk-4-1 libadwaita-1-0

# Python packages
pip3 install -r requirements.txt

# Ollama (if not installed)
curl -fsSL https://ollama.com/install.sh | sh
ollama pull gpt-oss:latest

2. Run the Assistant

# Qt version (recommended)
./run_assistant_qt.py

# GTK version (fallback)
./run_assistant.py

# Or direct execution
python3 usr/share/agentic-assistant/src/daemon_qt.py

4. Usage

• Press Ctrl+Space anywhere to activate the assistant
• Type natural language commands like:
  • "Open Firefox"
  • "Show system performance"
  • "sudo apt update && sudo apt upgrade -y" (secure password prompt)
  • "Create a directory called projects"
  • "List files in the current directory"
• Enter sudo password when prompted for privileged operations
• Press Escape or click outside to dismiss

Features

• 🎨 Advanced glassmorphism UI with Qt6/PySide6 and animated message bubbles
• 🔒 Secure sudo authentication with in-chat password prompts
• 🚀 Global hotkey support (Ctrl+Space) across all desktop environments
• 🤖 Local LLM integration via Ollama with real-time streaming responses
• 🔧 Full system control through natural language commands
• 💬 Professional chat interface with loading animations and glassmorphism effects
• 🖥️ Cross-platform compatibility (Wayland/X11, GNOME/KDE/XFCE)
• ⚡ Production-ready systemd integration with security hardening

Architecture

Core Components

• daemon_qt.py - Primary Qt-based service with multi-threaded hotkey detection
• overlay_gui_qt.py - Advanced Qt6/PySide6 interface with glassmorphism UI
• daemon.py - Fallback GTK4 service
• overlay_gui.py - Fallback GTK4 interface
• ollama_client.py - Async LLM communication with streaming support
• system_integration.py - Secure command execution with sudo authentication

Technical Highlights

• Dual UI Framework: Qt6 (primary) + GTK4 (fallback) for maximum compatibility
• Advanced Threading: Multi-threaded architecture with async I/O operations
• Security Features: Secure sudo password handling with input validation
• Real-time Streaming: Sub-100ms response times with chunked LLM output
• Cross-platform: Native support for Wayland, X11, and all major Linux DEs

This is the core application repository. Distribution packaging and system integration are production-ready.