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

1. Clone the repository:

git clone https://github.com/MagicUnicornInc/KognitiveKompanion.git
cd KognitiveKompanion

2. Install dependencies:

pip install -r requirements.txt

3. 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