Kognitivekompanion

🚀 认知助手（KognitiveKompanion）

认知助手（KognitiveKompanion）是一款现代化且功能多样的人工智能界面，专为KDE及其他桌面环境打造。它能够实现与各类AI后端的无缝交互，支持OpenAI、Ollama，还具备AMD Ryzen AI硬件加速功能。

✨ 主要特性

• 多后端支持：
  • 集成OpenAI API，支持GPT - 4o、GPT - 3.5 - Turbo等模型。
  • 采用Ollama后端，可使用本地模型。
  • 具备AMD Ryzen AI硬件加速能力。
• 高级UI：
  • 界面部分可折叠，保持简洁。
  • 设有聊天侧边栏，方便管理聊天历史。
  • 采用现代样式，与KDE主题集成。
  • 提供系统托盘图标和浮动窗口选项。
• 上下文功能：
  • 支持屏幕捕获，提供视觉上下文。
  • 支持音频输入。
  • 可切换RAG（增强检索生成）功能。
• 对话管理：
  • 可保存和加载对话。
  • 能导出聊天记录。

📦 安装指南

先决条件

• Python 3.8+（推荐Python 3.12）
• PyQt5
• KDE Plasma 5桌面环境（可选，其他桌面环境也可用）
• 以下其中一个后端：
  • OpenAI API密钥
  • Ollama本地运行
  • AMD Ryzen AI兼容硬件（可选）

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

pip install -r requirements.txt

3. 使用您首选的后端运行应用程序：

# OpenAI后端
./run_openai_gui.sh

# Ollama后端
./run_kde_ai_interface.py

# AMD Ryzen AI（如果硬件支持可用）
./run_ryzen_ai_model.py

📚 详细文档

配置说明

请参阅MULTI_BACKEND_GUIDE.md以获取不同后端的详细设置说明。

对于AMD Ryzen AI的特定设置，请参阅README_RYZEN_AI_SETUP.md。

项目结构

├── app_root/             # 应用程序核心代码
│   ├── ui/               # UI组件和小部件
│   ├── mcp/              # 模型控制协议客户端
│   ├── config/           # 配置管理
│   ├── rag/              # 增强检索生成
│   ├── system/           # 系统集成与优化
│   └── utils/            # 工具函数
├── amd-ryzen-ai/         # AMD Ryzen AI集成
├── quark-integration/    # 量化工具包集成
└── MCP-INTEGRATION-GUIDE.md  # MCP服务器文档

项目状态

请参阅PROJECT_STATUS.md以获取当前开发状态和路线图。

📄 许可证

该项目根据MIT许可证发布 - 请参阅LICENSE文件以获取详细信息。

💪 贡献

欢迎贡献！请随意提交拉取请求。

🙏 致谢

• KDE社区
• OpenAI和Ollama项目
• AMD对Ryzen AI的支持
• PyQt/Qt开发者