nekro-agent
NekroAgent 是一个面向多人互动场景的跨平台 Agent 框架，集 Claude Code 沙盒执行、工作区编排、长期记忆、结构化 MCP 管理与可视化控制台于一体，兼具高扩展性、多模态交
What is nekro-agent?
NekroAgent 是一个面向多人互动场景的跨平台 Agent 框架，集 Claude Code 沙盒执行、工作区编排、长期记忆、结构化 MCP 管理与可视化控制台于一体，兼具高扩展性、多模态交互、实时状态推送和自动化运行能力。项目支持 QQ、Discord、Telegram、Minecraft、BilibiliLive、WeChat、Email、SSE(SDK) 等多种平台接入，应用于构建高智能聊天机器人，可扩展为具备代码执行、工具调用、插件协作和复杂任务处理能力的通用 Agent 系统
Overview of nekro-agent
What it is
NekroAgent is a cross-platform Agent framework designed for multi-user interaction scenarios. It integrates Claude Code sandbox execution, workspace orchestration, long-term memory, structured MCP management, and a visual console. It supports high extensibility, multimodal interaction, real-time status push, and automated operation. The project supports multiple platform adapters including QQ (via OneBot v11), Discord, Telegram, Minecraft, Bilibili Live, WeChat, Email, and SSE+SDK.
Key features
- Code generation and secure sandbox execution in a containerized environment.
- Highly extensible plugin system with callback hooks, prompt injection, and custom sandbox methods.
- Native multi-user scenario interaction for group chats.
- Automatic error correction and feedback mechanism.
- Multi-platform adapter architecture with unified development interface.
- Native multimodal visual understanding (images, files).
- Event-driven asynchronous architecture.
- Cloud resource sharing (plugins, personas) and community-driven ecosystem.
- Feature-rich visual WebUI for management and monitoring.
- Preview features: Workspace/Claude Code sandbox, Memory System (long-term memory with vector retrieval), structured MCP service management, command system refactor, timers and governance enhancements.
Use cases
- Emotional interaction and companionship with customizable personas and memory.
- Data and file processing (images, documents, format conversion).
- Creative and development assistance (web app generation, data visualization).
- Automation and integration (event subscription, multi-AI collaboration).
- Learning and life assistant (tutoring, content creation, smart home control).
Getting started
Quick deployment script (recommended): ```bash sudo -E bash -c $(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/install.sh)
- --with-napcat
Or from NekroEndpoint mirror:bash sudo -E bash -c $(curl -fsSL https://ep.nekro.ai/e/KroMiose/nekro-agent/main/docker/install.sh) - --with-napcat
Docker images:bash docker pull kromiose/nekro-agent:latest docker pull kromiose/nekro-agent:preview ``` For detailed tutorials, see the repository README.
License and pricing
The project is open source under a custom license (based on Apache License 2.0 with modifications). Pricing is not stated; the project is free and open source.
Based on the project's public README and repository metadata.
