Kognitivekompanion

🚀 KognitiveKompanion

A modern and versatile AI interface designed for KDE and other desktop environments, enabling 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
  • Chat sidebar for managing chat history
  • Modern styling integrated with KDE themes
  • System tray icon and floating window options
• Contextual Features:
  • Screen capture function to provide visual context
  • Audio input support
  • RAG (Retrieval Augmented Generation) toggle
• Conversation Management:
  • Save and load conversations
  • Export chat history

📦 Installation

Prerequisites

• Python 3.8+ (Python 3.12 recommended)
• PyQt5
• KDE Plasma 5 desktop environment (optional, other desktop environments are also available)
• One of the following backends:
  • OpenAI API key
  • Ollama running locally
  • AMD Ryzen AI compatible hardware (optional)

Steps

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 hardware support is available)
./run_ryzen_ai_model.py

📚 Documentation

Configuration

Refer to MULTI_BACKEND_GUIDE.md for detailed setup instructions for different backends.

For specific setup of AMD Ryzen AI, refer to README_RYZEN_AI_SETUP.md.

Project Structure

├── app_root/             # Application core 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

Refer to PROJECT_STATUS.md for the current development status and roadmap.

🤝 Contribution

Contributions are welcome! Feel free to submit pull requests.

🙏 Acknowledgments

• KDE Community
• OpenAI and Ollama projects
• AMD for Ryzen AI support
• PyQt/Qt developers