RTGS2017/NagaAgent

NagaAgent – 以桌面為中心的AI助理

是什麼 – NagaAgent 是一個開源、跨平台的桌面應用程式（Windows/macOS/Linux），整合了大型語言模型（LLM）聊天介面與豐富的「代理」工具。它採用 Python 後端（FastAPI、Neo4j、LiteLLM）與 Electron/Vue 前端建構，目標使用者是希望擁有一個能記住過去對話、呼叫外部工具、渲染 Live2D 動畫頭像，甚至控制電腦（啟動應用、瀏覽網頁、玩遊戲）的個人AI夥伴的人。

---

核心功能（如 README 所述）

領域	NagaAgent 的功能
聊天與工具呼叫	支援任意 OpenAI 相容提供者或 Anthropic 的串流 LLM 回應，使用自訂的「tool」JSON 塊語法，由後端解析並執行。每回合最多支援 5 次工具呼叫循環。
記憶（GRAG）	從對話中提取主語-謂語-賓語五元組事實，本地及 Neo4j 圖資料庫中儲存，並自動為後續回合檢索相關事實（圖-RAG）。
Live2D 頭像	顯示一個 2D 動畫角色（Live2D Cubism），可回應滑鼠移動、語音與工具事件。使用者可上傳自己的模型目錄。
語音	使用 Edge-TTS 進行語音合成（按句串流輸出），使用 FunASR / Qwen-Omni 進行語音轉文字，透過唇形同步驅動 Live2D 面部。
MCP 工具框架	一個插件系統（Model Context Protocol），內建天氣、系統啟動器、遊戲指南、網頁搜尋、網頁抓取、Playwright 自動化、視覺、MQTT、文件提取等代理。無需重啟即可新增新代理。
OpenClaw 集成	一個本地「代理伺服器」，可執行任意 Python/Playwright 任務，排程任務，並將結果回報至聊天。
知識圖譜 UI	Neo4j 圖譜的 3D 「記憶雲」可視化（節點=實體，邊=謂詞），支援滑鼠拖曳旋轉、縮放與關鍵字過濾。
社群功能	內建論壇（娜迦網絡）、積分/親和度系統、用於下載社群製作技能的市場，以及背景、音樂與角色包的「市場」。
浮球模式	一個輕量級始終置頂視窗，可切換緊湊、完整與經典佈局，便於快速聊天存取。
音樂播放器	集成的 BGM 播放器，支援播放清單，並與 TTS 唇形同步。

---

快速開始（來自 README）

1. 克隆與安裝

   git clone https://github.com/Xxiii8322766509/NagaAgent.git
   cd NagaAgent
   # 前端
   cd frontend && npm install && cd ..
   # 後端（推薦）
   uv sync   # 或建立 venv 並 pip install -r requirements.txt
   

2. 設定 – 將 config.json.example 複製為 config.json，並填入 LLM API 金鑰（DeepSeek、OpenAI、Anthropic、Ollama 等）。
3. 執行 – 執行前端腳本 npm run dev 將啟動 Electron 窗口並自動啟動 Python 服務。

---

典型使用情境

• 個人AI夥伴 – 與一個能記住你偏好、風格化的頭像聊天，跨會話保持記憶。
• 工具增強工作流程 – 讓助手搜尋網頁、取得文件、啟動應用或透過內建 MCP 代理控制物聯網設備。
• 遊戲輔助 – 使用 game_guide 技能取得策略建議、自動識別遊戲畫面，或與外部機器人（如 MAA）聯動實現自動化遊戲。
• 知識管理 – 讓系統從對話中提取事實，儲存在 Neo4j 圖譜中，後續可作為新對話的上下文進行查詢。
• 語音優先互動 – 與助手說話並聽到回應，頭像即時進行唇形同步。

---

授權

• 雙重授權：AGPL-3.0（開源部分）與商業用途的專有「閉源」授權（需書面許可）。倉儲包含 LICENSE（AGPL）與 LICENSE-CLOSED-SOURCE 兩個檔案。

---

總結

NagaAgent 是一個全棧、以桌面為中心的 AI 助手，整合了 LLM 聊天、工具呼叫、基於圖的記憶、Live2D 頭像渲染、語音 I/O 與插件生態系統。它是一個真正的軟體專案，旨在為希望擁有可擴展、視覺豐富的 AI 伴侶，而非簡單教程或精選清單的使用者提供服務。