RTGS2017/NagaAgent

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

What it solves

NagaAgent는 "anime-style"(ACG) 커뮤니티를 위해 설계된 종합 AI 어시스턴트로, 가상 Live2D 아바타와 고급 LLM 기능을 결합합니다. 매우 인터랙티브하고 개인화된 데스크톱 동반자를 만들고자 하는 문제를 해결하며, 채팅뿐 아니라 시스템 작업 수행, 지식 그래프를 통한 장기 기억 관리, 외부 도구 및 커뮤니티 포럼과의 통합을 가능하게 합니다.

How it works

프로젝트는 API Server, Agent Server, MCP Server, Voice Service 로 구성된 마이크로서비스 아키텍처를 사용하며, 중앙 진입점에서 이들을 조정합니다.

  • Interaction: Vue 3/Electron 프론트엔드와 Live2D 아바타를 활용해 TTS(텍스트‑투‑스피치)와 입 움직임을 동기화하고 마우스 커서를 따라다니게 합니다.
  • Intelligence: OpenAI, DeepSeek, Anthropic 등 다양한 LLM 제공자를 지원하고, 스트리밍 툴 호출 루프를 구현해 AI가 함수(웹 검색, 앱 실행 등)를 실행하고 결과를 대화에 다시 전달할 수 있게 합니다.
  • Memory: Graph‑RAG(GRAG)를 사용해 대화에서 "quintuples"(subject, type, predicate, object, type)를 추출하고 Neo4j 그래프 데이터베이스에 저장해 장기 검색을 가능하게 합니다.
  • Control: OpenClaw와 통합해 로컬 컴퓨터를 제어하고, Model Context Protocol(MCP)으로 특화된 에이전트(날씨, 비전, IoT 제어 등)의 플러그인 아키텍처를 제공합니다.

Who it’s for

  • 데스크톱에 시각적으로 매력적인 anime‑style AI 동반자를 원하는 사용자.
  • 로컬 시스템을 제어하고 웹을 탐색할 수 있는 에이전시 AI를 찾는 파워 유저.
  • Live2D 아바타와 LLM, Graph‑RAG 메모리 시스템 통합에 관심이 있는 개발자.

Highlights

  • Live2D Integration: 4채널 직교 애니메이션 시스템과 SSAA 안티앨리어싱을 갖춘 고충실도 가상 아바터.
  • Graph‑RAG Memory: Neo4j를 이용한 3D 시각화 "Mind Sea"에 사실을 자동 추출.
  • Pluggable Tools: MCP(Model Context Protocol)와 커뮤니티 설치 스킬 지원.
  • Multimodal Interaction: Qwen Omni를 통한 전이중 실시간 음성 인터랙션, ASR, 화면 캡처 기반 비전 작업.
  • Context Compression: 10만 토큰 이상의 긴 대화를 자동 요약해 컨텍스트 오버플로를 방지.