Nekro Agent is an extensible, multi-person interactive AI agent framework designed for LLM code generation and execution. It targets users seeking a flexible, secure, and feature-rich chatbot for tasks ranging from emotional companionship to complex data processing and development assistance. The framework offers a sandbox environment for safe code execution, multi-modal capabilities, and a robust plugin system, aiming to reduce costs and improve efficiency for complex AI-driven tasks.

How It Works

Nekro Agent leverages a sophisticated prompt engineering system to guide LLMs in generating, correcting, and executing code within a secure, containerized sandbox environment. Interaction with the real environment is facilitated via RPC. Its event-driven architecture prioritizes asynchronous operations for efficient responses. The system supports native multi-modal interactions, allowing it to process images and other resources directly.

Quick Start & Requirements

• Install/Run: A one-click deployment script is recommended:

  sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/quick_start_x_napcat.sh)"
  

• Prerequisites: Docker and docker-compose are required for the recommended deployment.
• Resources: Detailed deployment tutorials are available for Linux, Windows, and MacOS.
• Documentation: Nekro Agent 文档中心

Highlighted Details

• Secure containerized sandbox execution environment with a built-in Python runtime.
• Powerful code guidance, generation, correction, and execution capabilities, including chart generation.
• Native multi-modal support for visual understanding and interaction with images and files.
• Highly extensible plugin system with callbacks, prompt injection, and custom sandbox methods.
• Native support for multi-person chat scenarios and real-time resource sharing (plugins, personas) via a cloud community.
• Visual management panel (WebUI) for application management.

Maintenance & Community

• Community support is available via QQ group: 636925153.
• A cloud community (NekroAI 云社区) provides sharing of plugins and personas.
• Contribution guidelines are available, with a focus on adhering to license terms.

Licensing & Compatibility

• Distributed under a custom open-source license, modified from Apache License 2.0. Users must comply with the terms.

Limitations & Caveats

• Plugin development documentation is still under construction ("施工中").
• The project's custom license may have specific restrictions not present in standard Apache 2.0.