Push-to-talk voice
Ctrl+K starts a faster-whisper voice loop with interruptible LLM streaming and sentence-level Piper TTS.
Desktop companion / voice / memory
KIBO lives on your desktop.
A frameless animated character that listens for your voice, answers with neural TTS, remembers what matters, and can run cloud-fast with Groq or locally through Ollama and Piper fallbacks.
- Voice round-trip
- ~1.2s
- Tests
- 254 passing
- Idle CPU
- <2%
- Memory facts
- 200 cap
KIBO / transparent overlaystate: TALKING
sentence streaming
“You mentioned preferring espresso. Want me to remember that?”
Groq healthyPiper readyMemory enabled
What KIBO does
Not a chatbot widget.
KIBO is a desktop-resident companion: visible as a character, reachable through hotkeys, backed by a local memory vault, and governed by policy when it speaks first.
Long-term memory
Facts are embedded with sqlite-vec and also written to an Obsidian-compatible vault you can inspect and edit.
Animated desktop pet
A frameless transparent companion uses VP9 alpha WebM states for idle, thinking, talking, acting, and happy moments.
Policy-gated proactivity
Morning greetings, idle check-ins, battery alerts, and meeting reminders obey quiet hours, snooze, and daily caps.
Runtime stack
Cloud-fast, locally capable.
Each dependency has a graceful degradation path so the app can still start when keys, models, or network access are missing.
LLM
Groq cloud
Ollama local
Mock demo
TTS
Piper neural
pyttsx3 fallback
Mock audio
Memory
sqlite-vec
Lexical fallback
Markdown vault
Trust model
Proactive only after permission.
01
First-run wizard explains provider choice, audio, privacy, hotkeys, and tray controls.
02
Memory and proactive behavior are explicit opt-ins with settings to inspect, edit, delete, clear, snooze, or disable.
03
Diagnostics export redacts sensitive data by default and keeps logs under the local ~/.kibo directory.
Quick start
Run the companion locally.
Install with uv, optionally add Groq and Piper, then launch the Python backend and Electron frontend.
git clone https://github.com/yash-dev007/KIBO.git
cd KIBO
pip install uv
uv sync
# Windows launcher
KIBO.batBackend API runs on port 8765.
Local data lives under ~/.kibo.