Kavio (Finnish for "Hoof") is a sturdy, multimodal AI companion application built for Windows. It brings the power of Google's Gemini 2.5 Flash model directly to your desktop, featuring voice-to-voice interaction, long-term memory, and a sophisticated multi-profile system.
- Multi-Profile Sidebar: A persistent sidebar allows you to instantly switch between different AI personas (e.g., "Coding Assistant", "Therapist").
- Long-Term Memory: Kavio remembers details about you using a local vector database.
- Text-to-Speech: Listen to your AI speak with a lifelike voice using the Gemini TTS model.
- Tools: The AI can now perform actions like checking the current time or calculating math problems.
- Multimodal Intelligence:
- Vision: Drag and drop images for analysis.
- Code & Text: Attach
.txt,.py,.md, or.jsonfiles to have the AI analyze your code or documents.
- Voice-to-Voice: Low-latency speech recognition and synthesis.
- Modern UI: A dark-themed, glass-morphic interface built with
customtkinter.
- Python 3.10+: Ensure Python is installed and added to your system PATH.
- Note: Avoid "Pre-release" versions like Python 3.14. Python 3.11 or 3.12 is recommended.
- Google AI Studio API Key: You need a free API key from Google AI Studio.
- Clone or Download this repository.
- Edit
kavio.py:- Open the file in a text editor.
- Find the line
API_KEY = ""and paste your Google API key inside the quotes. - (Optional) Use the included
key_injector.pytool to do this automatically.
Double-click the launcher.bat file.
- It will automatically check for and install missing libraries.
- It will launch the main application.
- Use the Sidebar on the left to click on a profile to switch to it.
- Click "+ Create New" to build a new persona.