RTGS2017/NagaAgent

A simple yet powerful agent framework for personal assistants, designed to enable intelligent interaction, multi-agent collaboration, and seamless tool integration.

NagaAgent – デスクトップ中心のAIアシスタント

何であるか – NagaAgentは、オープンソースでクロスプラットフォームのデスクトップアプリケーション（Windows/macOS/Linux）であり、大規模言語モデル（LLM）チャットインターフェースと豊富な「エージェント機能」ツールを統合しています。Pythonバックエンド（FastAPI、Neo4j、LiteLLM）とElectron/Vueフロントエンドで構築されており、過去の会話を記憶し、外部ツールを呼び出し、Live2Dアバターをレンダリングし、コンピュータを制御（アプリ起動、Web閲覧、ゲームプレイなど）できる個人用AIコンパニオンを求めるユーザーをターゲットとしています。

コア機能（READMEに記載）

分野	NagaAgentの機能
チャットとツール呼び出し	任意のOpenAI互換プロバイダーまたはAnthropicに対応したストリーミングLLM応答。バックエンドが解析・実行するカスタム「`tool`」JSONブロック構文をサポート。1ターンあたり最大5回のツールコールループをサポート。
メモリ（GRAG）	会話から主語-述語-目的語の5項組（quintuple）の事実を抽出し、ローカルおよびNeo4jグラフに保存。後続のターンで関連する事実を自動的に取得（Graph-RAG）。
Live2Dアバター	マウス移動、発話、ツールイベントに反応する2Dアニメーションキャラクター（Live2D Cubism）を表示。ユーザーは独自のモデルディレクトリをアップロード可能。
音声	音声合成にはEdge-TTS（文単位ストリーミング）、音声認識にはFunASR / Qwen-Omniを採用。リップシンクによりLive2D顔を制御。
MCPツールフレームワーク	プラグインシステム（Model Context Protocol）で、天気、システム起動、ゲームガイド、Web検索、Webスクレイピング、Playwright自動化、ビジョン、MQTT、ドキュメント抽出などに対応。再起動なしで新規エージェントを追加可能。
OpenClaw統合	任意のPython/Playwrightタスクを実行可能で、スケジューリングと結果のチャットへの報告を可能にするローカル「エージェントサーバー」。
知識グラフUI	Neo4jグラフの3D「メモリクラウド」可視化（ノード＝エンティティ、エッジ＝述語）。マウスドラッグによる回転、ズーム、キーワードフィルタリングをサポート。
コミュニティ機能	内蔵フォーラム（娜迦网络）、ポイント/親和性システム、コミュニティ作成スキルのダウンロードマーケット、背景、音楽、キャラクターパックのマーケット。
フローティングボールモード	軽量な常に前面表示ウィンドウ。コンパクト、フル、クラシックの3つのレイアウトを切り替え可能で、迅速なチャットアクセスを可能に。
音楽プレイヤー	プレイリスト対応の統合BGMプレイヤー。TTSのリップシンクと同期。

クイックスタート（READMEより）

クローン＆インストール

git clone https://github.com/Xxiii8322766509/NagaAgent.git
cd NagaAgent
# フロントエンド
cd frontend && npm install && cd ..
# バックエンド（推奨）
uv sync   # または venv を作成し pip install -r requirements.txt

設定 – config.json.example を config.json にコピーし、LLM APIキー（DeepSeek、OpenAI、Anthropic、Ollamaなど）を入力。
実行 – フロントエンドスクリプト npm run dev を実行すると、Electronウィンドウが起動し、Pythonサービスも自動的に開始されます。

一般的な利用例

個人用AIコンパニオン – セッション間で好みを記憶するスタイリッシュなアバターとチャット。
ツール拡張ワークフロー – エージェントを使ってWeb検索、ドキュメント取得、アプリ起動、IoTデバイス制御などを依頼可能。
ゲーム支援 – game_guideスキルで戦略アドバイスを取得、ゲーム画面を自動認識、外部ボット（例：MAA）と連携して自動プレイ。
知識管理 – 会話から事実を抽出し、Neo4jグラフに保存。新しいチャットのコンテキストとして後から照会可能。
音声優先インタラクション – アシスタントに話しかけ、音声で応答を聞く。アバターにリアルタイムリップシンクを反映。

ライセンス

ダブルライセンス：AGPL-3.0（オープンソース部分）と商業利用向けの独自「クローズドソース」ライセンス（書面による許可が必要）。リポジトリには LICENSE（AGPL）と LICENSE-CLOSED-SOURCE の両方のファイルが含まれます。

まとめ

NagaAgentは、LLMチャット、ツール呼び出し、グラフベースメモリ、Live2Dアバターレンダリング、音声I/O、プラグインエコシステムを統合したフルスタックでデスクトップ中心のAIアシスタントです。単なるチュートリアルやカスタマイズ済みリストではなく、拡張可能で視覚的に豊かなAIコンパニオンを求めるユーザー向けの本格的なソフトウェアプロジェクトです。