KognitiveKompanion
by MagicUnicornInc
KognitiveKompanion is a versatile AI interface designed for KDE and other desktop environments. It provides seamless interaction with various AI backends like OpenAI, Ollama, and AMD Ryzen AI.
Last updated: N/A
KognitiveKompanion
A modern, versatile AI interface for KDE and other desktop environments, designed to provide a seamless interaction with various AI backends including OpenAI, Ollama, and AMD Ryzen AI hardware acceleration.
Features
- Multi-Backend Support:
- OpenAI API integration (GPT-4o, GPT-3.5-Turbo, etc.)
- Ollama backend for local models
- AMD Ryzen AI hardware acceleration
- Advanced UI:
- Collapsible sections for a clean interface
- Conversation sidebar for managing chat history
- Modern styling with KDE theming integration
- System tray icon and floating window option
- Context Features:
- Screen capture capability for visual context
- Audio input support
- RAG (Retrieval-Augmented Generation) toggle
- Conversation Management:
- Save and load conversations
- Export chat history
Requirements
- Python 3.8+ (Python 3.12 recommended)
- PyQt5
- KDE Plasma 5 Desktop (optional, works on other desktops too)
- One of the following backends:
- OpenAI API key
- Ollama running locally
- AMD Ryzen AI compatible hardware (optional)
Installation
- Clone the repository:
git clone https://github.com/MagicUnicornInc/KognitiveKompanion.git
cd KognitiveKompanion
- Install dependencies:
pip install -r requirements.txt
- Run the application with your preferred backend:
# OpenAI backend
./run_openai_gui.sh
# Ollama backend
./run_kde_ai_interface.py
# AMD Ryzen AI (if supported hardware is available)
./run_ryzen_ai_model.py
Configuration
See MULTI_BACKEND_GUIDE.md for detailed setup of different backends.
For AMD Ryzen AI specific setup, see README_RYZEN_AI_SETUP.md.
Project Structure
├── app_root/ # Core application code
│ ├── ui/ # UI components and widgets
│ ├── mcp/ # Model Control Protocol client
│ ├── config/ # Configuration management
│ ├── rag/ # Retrieval-Augmented Generation
│ ├── system/ # System integration and optimization
│ └── utils/ # Utility functions
├── amd-ryzen-ai/ # AMD Ryzen AI integration
├── quark-integration/ # Quantization toolkit integration
└── MCP-INTEGRATION-GUIDE.md # MCP server documentation
License
This project is licensed under the MIT License - see the LICENSE file for details.
Project Status
See PROJECT_STATUS.md for the current development status and roadmap.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Acknowledgments
- KDE Community
- OpenAI and Ollama projects
- AMD for Ryzen AI support
- PyQt/Qt developers