KroMiose/nekro-agent

What it solves

Nekro Agent is a highly extensible AI bot framework designed to bridge the gap between large language models (LLMs) and real-world interaction platforms. It solves the problem of deploying AI agents that can actually execute tasks via code, maintain long-term memory, and interact across multiple chat platforms (like Discord, Telegram, and QQ) using a unified interface.

How it works

The system uses an input/output stream architecture where platform-specific adapters (e.g., for Minecraft or Bilibili) handle the communication, while a core engine manages the business logic. To perform complex tasks, the agent guides the AI to generate code that is executed within a secure, containerized sandbox. It also incorporates a Memory System for long-term context and supports the Model Context Protocol (MCP) for structured external tool management.

Who it’s for

• Bot Developers: Those looking to build and deploy sophisticated AI agents with minimal setup.
• Community Managers: Users wanting to integrate AI assistants into group chats for emotional companionship or task automation.
• Power Users: Individuals needing a multi-modal AI assistant that can process files and images across different platforms.

Highlights

• Secure Code Execution: Executes AI-generated code in a containerized sandbox for safe method-level extensibility.
• Multi-Platform Support: Native adapters for OneBot v11, Discord, Telegram, Minecraft, Bilibili Live, WeChat, and Email.
• Long-Term Memory: A preview system featuring entity-relationship mapping and vector retrieval for persistent context.
• ** uma Unified WebUI**: A comprehensive visual management panel for monitoring agent behavior and configuring settings.
• MCP Integration: Structured management of external tools and MCP services via a registry and card-based interface.