认知伙伴

一个现代且多功能的AI界面，适用于KDE和其他桌面环境，旨在无缝连接到包括OpenAI、Ollama以及AMD Ryzen AI硬件加速在内的多种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。

贡献

欢迎贡献！请随意提交Pull Request。

致谢

• KDE社区
• OpenAI和Ollama项目团队
• AMD的Ryzen AI支持
• PyQt/Qt开发人员