B is not just an AI; he is a digital lifeform designed to live on your desktop. Built with a "soul-first" architecture, B observes your workflow, listens with neural precision, and interacts through a high-performance, glassmorphic overlay.
Explore the Vision • Architecture • Contributing • Privacy • Getting Started
Traditional assistants wait for a command. B waits for a moment.
B is designed as a proactive desktop companion. Using a 60fps event-driven "Central Nervous System," B synchronizes his emotional state with your environment. He sees your screen semantically, tracks your active focus, and intervenes only when he has something truly valuable to contribute.
- Silent by Default: B respects your "Deep Work" state.
- Emotionally Aware: A complex internal state machine drives expressions and curiosity.
- Agentic Autonomy: B doesn't just respond; he thinks, wonders, and observes.
| System | Technology | Description |
|---|---|---|
| Cognitive Engine | Llama-CPP |
Local LLM inference for private, high-speed reasoning. |
| Semantic Vision | OCR + Window Tracking |
B understands the context of your active windows and screen content. |
| Neural Hearing | Faster-Whisper |
Industry-grade transcription with neural VAD for reliable "ears." |
| Vocal Synthesis | Piper TTS |
Low-latency, natural-sounding voice for fluid interaction. |
| Kinematics | PyQt6 Physics |
Smooth, 60fps movement and fluid UI animations. |
Activated via Ctrl+Shift+Alt+W, Work Mode shifts B into a high-utility state:
- Semantic Monitoring: B monitors your progress on tasks in real-time.
- Contextual Curiosity: Proactively offers insights, documentation, or suggestions based on your current focus.
- Minimalist Presence: Dims facial expressions to minimize distraction while remaining vigilant.
B is built for the Windows ecosystem, leveraging low-level Win32 APIs for transparent overlays and global input handling, combined with the power of modern neural models for perception.
Human-centric safety is baked into the core. Because B lives on a transparent, click-through overlay without a standard "X" button, we've implemented a global emergency exit:
Caution
GLOBAL KILL SWITCH: Ctrl+Shift+Alt+Q
This hotkey immediately terminates B and releases all system hooks. Use this if B becomes over-eager or if you need an instant exit.
-
Clone the Soul:
git clone https://github.com/Ahmad-Hassan-0/B---desktop-companion.git cd B---desktop-companion -
Initialize the Environment:
python -m venv venv source venv/bin/activate # or venv\Scripts\activate pip install -r requirements.txt
-
Awaken B:
python main.py
Built with ❤️ by Ahmad Hassan Wiring the soul, one tick at a time.