🍺 Skippy the Magnificent¶

Your AI Desktop Companion

Version 1.7.0 | Built with OpenClaw

What is Skippy?¶

Skippy is a floating desktop AI assistant that lives in your system tray and provides instant access to AI-powered help. Unlike web-based chatbots, Skippy:

Runs locally on your Windows desktop
Stays always-on-top for quick access
Syncs with WhatsApp for mobile access
Understands images via paste (Ctrl+V)
Talks and listens with voice input/output
Controls your desktop through automation tools

✨ Key Features¶

- :material-chat: **Chat Interface** Floating window with real-time streaming responses, thinking display, and conversation history. - :material-microphone: **Voice Input** Push-to-talk with local Whisper STT or Google Speech Recognition fallback. - :material-volume-high: **Voice Output** Natural-sounding responses via Edge TTS with multiple voice options. - :material-whatsapp: **WhatsApp Sync** Two-way messaging - chat from your phone, get responses on desktop. - :material-monitor-screenshot: **Screenshots** Capture single or all monitors, auto-scaled for AI vision analysis. - :material-robot: **Automation** PowerShell toolkit and AutoHotkey integration for desktop control. - :material-brain: **Local LLM** Run AI models locally with Ollama for offline capability, privacy, and cost savings.

🚀 Quick Start¶

1. Launch Skippy¶

cd C:\Users\ejb71\SkippyBuddy
pythonw skippy.py

Or use the launcher:

run.bat

2. Start Chatting¶

Click the Skippy icon in your system tray (or double-click)
Type in the input field and press Enter
Paste images with Ctrl+V

3. Enable Voice (Optional)¶

Hold the 🎤 button to talk (push-to-talk)
Click 🔇 to enable spoken responses
Configure voices in the tray menu

📋 System Requirements¶

Requirement	Minimum	Recommended
OS	Windows 10	Windows 11
Python	3.10+	3.12+
RAM	4 GB	8 GB (with Whisper)
Disk	500 MB	2 GB (with models)

Required Packages¶

PyQt6
edge-tts
faster-whisper (optional, for local STT)
sounddevice
numpy

🔗 Quick Links¶

Getting Started - Installation and first run
Configuration - All settings explained
PowerShell Tools - Autonomous capabilities
Troubleshooting - Common issues and solutions

💡 Tips¶

Keyboard Shortcuts

Enter - Send message
Ctrl+V - Paste image
Hold 🎤 - Voice input
Escape - Minimize to tray

WhatsApp Integration

Messages from WhatsApp appear with a 📱 icon. Responses are automatically synced back!

Built with ❤️ by Skippy the Magnificent