认知助手（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服务器文档

许可证

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

项目状态

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

贡献

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

致谢

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