---
slug: "kognitivekompanion-mcp服务器"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/SkyBehind/KognitiveKompanion@master/README.md"
repo: "https://github.com/SkyBehind/KognitiveKompanion"
source_file: "README.md"
branch: "master"
---
# 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:
```bash
git clone https://github.com/MagicUnicornInc/KognitiveKompanion.git
cd KognitiveKompanion
```

2. Install dependencies:
```bash
pip install -r requirements.txt
```

3. Run the application with your preferred backend:
```bash
# 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](https://github.com/SkyBehind/KognitiveKompanion/blob/HEAD/MULTI_BACKEND_GUIDE.md) for detailed setup of different backends.

For AMD Ryzen AI specific setup, see [README_RYZEN_AI_SETUP.md](https://github.com/SkyBehind/KognitiveKompanion/blob/HEAD/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](https://github.com/SkyBehind/KognitiveKompanion/tree/HEAD/LICENSE) file for details.

## Project Status

See [PROJECT_STATUS.md](https://github.com/SkyBehind/KognitiveKompanion/blob/HEAD/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