Kognitivekompanion

🚀 認知助手（KognitiveKompanion）

認知助手是一款現代化且功能多樣的人工智能界面，專為KDE及其他桌面環境打造。它能實現與OpenAI、Ollama等各類AI後端的無縫交互，還支持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服務器文檔

項目狀態

請參閱PROJECT_STATUS.md以獲取當前開發狀態和路線圖。

📄 許可證

該項目根據MIT許可證發佈 - 請參閱LICENSE文件以獲取詳細信息。

貢獻

歡迎貢獻！請隨意提交拉取請求。

致謝

• KDE社區
• OpenAI和Ollama項目
• AMD對Ryzen AI的支持
• PyQt/Qt開發者