{"id":28169204,"url":"https://github.com/kromiose/nekro-agent","last_synced_at":"2025-05-15T16:16:13.515Z","repository":{"id":252897314,"uuid":"834050728","full_name":"KroMiose/nekro-agent","owner":"KroMiose","description":"集代码执行能力/高度可扩展性为一体的多人聊天机器人：容器化｜沙盒化｜UI 化｜可扩展｜多模态; An Extensible Multi-person interactive Agent Framework Powered by LLM Code Generation","archived":false,"fork":false,"pushed_at":"2025-05-13T13:07:31.000Z","size":6492,"stargazers_count":219,"open_issues_count":5,"forks_count":16,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-13T13:15:40.382Z","etag":null,"topics":["agent","chatbot","multiuserchat","openai","sandbox"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KroMiose.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-07-26T10:01:33.000Z","updated_at":"2025-05-13T13:07:23.000Z","dependencies_parsed_at":"2024-08-26T03:44:44.847Z","dependency_job_id":"044939b1-7659-4c47-8535-d207378f9cc8","html_url":"https://github.com/KroMiose/nekro-agent","commit_stats":null,"previous_names":["kromiose/nekro-agent"],"tags_count":185,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KroMiose%2Fnekro-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KroMiose%2Fnekro-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KroMiose%2Fnekro-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KroMiose%2Fnekro-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KroMiose","download_url":"https://codeload.github.com/KroMiose/nekro-agent/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254374544,"owners_count":22060614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","chatbot","multiuserchat","openai","sandbox"],"created_at":"2025-05-15T16:16:12.012Z","updated_at":"2025-05-15T16:16:13.507Z","avatar_url":"https://github.com/KroMiose.png","language":"Python","funding_links":[],"categories":["Chatbots"],"sub_categories":[],"readme":"# Nekro Agent - 更智能、更优雅的代理执行 AI\n\n\u003c!-- markdownlint-disable MD033 MD041 --\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://doc.nekro.ai\"\u003e\u003cimg src=\"./images/README/NA_logo.png\" width=\"1024\" alt=\"NekroAgentLogo\"\u003e\u003c/a\u003e\u003cbr\u003e\n  \u003cp\u003e\u003cimg src=\"./images/README/NoneBotPlugin.svg\" width=\"240\" alt=\"NoneBotPluginText\"\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  ✨ 高可扩展 | 高自由度 | 极简部署 的 AI 聊天 \u0026 代理执行 Bot! ✨\u003cbr/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/python-3.9+-6a9.svg\" alt=\"python\"\u003e\n  \u003ca href=\"https://pypi.python.org/pypi/nekro-agent\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/v/nekro-agent.svg\" alt=\"pypi\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/u/kromiose\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Docker Pulls\" src=\"https://img.shields.io/docker/pulls/kromiose/nekro-agent?color=%20%23EA5252\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://qm.qq.com/q/eT30LxDcSA\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/加入交流群-636925153-c42.svg\" alt=\"python\"\u003e\n  \u003c/a\u003e\n  \u003cbr/\u003e\n  🚅 源自首批大模型应用 \u003ca href=\"https://github.com/KroMiose/nonebot_plugin_naturel_gpt\"\u003eNaturel GPT\u003c/a\u003e 的 Agent 升级重构续作 🌈\u003cbr/\u003e\n  📚 \u003ca href=\"https://doc.nekro.ai\"\u003eNekro Agent 文档中心\u003c/a\u003e 提供完整的入门指南与开发文档 📚\u003cbr/\u003e\n  💬 技术交流/答疑/讨论：\u003ca href=\"https://qm.qq.com/q/eT30LxDcSA\"\u003e加入社区交流群: 636925153\u003c/a\u003e 🗨️ \u003cbr/\u003e\n  🚀 \u003ca href=\"https://community.nekro.ai\"\u003eNekroAI 云社区\u003c/a\u003e 提供插件和人设实时自由共享，生态观测功能等你体验！ 🚀\u003cbr/\u003e\n\u003c/div\u003e\n\n## 🚀 核心能力\n\nNekroAgent 通过强大灵活的提示词构建系统，引导 AI 生成准确的代码并在沙盒中执行，通过 RPC 通信来与真实环境交互。主要特点包括：\n\n- 安全的容器化 **沙盒执行环境**，内置完整的 Python 运行时环境\n- 强大的代码 **引导、生成、纠错、执行** 能力，支持图表生成、通用内容处理等复杂任务\n- 原生多模态 **视觉理解与交互** 支持，可处理图片、文件等多种资源\n- 高度可扩展的 **插件系统**，提供多种关键节点回调、提示词注入、自定义沙盒方法\n- 原生的 **多人场景互动** 支持，高效洞悉群聊场景需求\n- 云端实时资源共享服务，包括插件、人设等，强大友好的 **社区驱动** 能力\n- 功能齐全的 **可视化界面** 应用管理面板\n- 拒绝无效提示词与滥用迭代智能体，复杂任务的极致 **降本增效** 实践\n- 基于 **事件驱动** 的交互架构，遵循异步优先的高效响应机制\n\n## ⚙️ 效果演示\n\n![demo1](./images/README/demo1.png)\n\n## 🎨 应用场景\n\nNekro Agent 提供多样化的应用场景，从情感陪伴到复杂任务处理，满足各类需求：\n\n- 💖 **情感交互与陪伴**：通过灵活的人设系统和先进的大语言模型，提供自然流畅的情感互动体验，支持多种角色定制和可扩展的记忆能力\n- 📊 **数据与文件处理**：高效处理各类图像、文档及数据，无需额外软件支持，轻松完成格式转换与内容提取\n- 🎮 **创意与开发辅助**：从网页应用生成到数据可视化，让创意实现变得简单高效\n- 🔄 **自动化与集成**：支持事件订阅推送和多 AI 协作，实现复杂任务的智能自动化\n- 📚 **学习与生活助手**：从学习辅导到内容创作，再到智能家居控制，全方位提升生活品质\n\n👉 更多精彩用例与演示，请访问[应用场景展示页面](https://doc.nekro.ai/docs/01_intro/application_scenarios)！\n\n## 💡 功能列表\n\n- ✅ 群聊/私聊 场景的上下文智能聊天\n- ✅ 自定义人设与人设市场\n- ✅ 容器化沙盒执行环境\n- ✅ 图片资源交互 (支持 Bot 发送\u0026接收\u0026处理 图片资源)\n- ✅ 高度可扩展的插件系统与插件市场\n- ✅ 基于 `docker-compose` 的容器编排一键部署支持\n- ✅ 更多文件资源交互 (文件/视频/音频等)\n- ✅ 配置热更新与指令控制支持\n- ✅ 原生多模态理解支持 (支持通用图片理解能力)\n- ✅ 可视化应用管理控制面板 (WebUI 支持)\n- ✅ 外置思维链 (CoT) 能力支持\n- ✅ 定时器自触发插件与节日祝福\n- ✅ 更多事件通知理解上下文理解\n- ✅ 完善第三方插件能力及 AI 生成插件\n\n## 🎁 快速部署\n\n我们提供了多种部署方式，请访问 [快速开始文档](https://doc.nekro.ai/docs/02_quick_start/quickstart) 查看详细教程：\n\n- [Linux 部署教程](https://doc.nekro.ai/docs/02_quick_start/deploy/linux)\n- [Windows 部署教程](https://doc.nekro.ai/docs/02_quick_start/deploy/windows)\n- [MacOS 部署教程](https://doc.nekro.ai/docs/02_quick_start/deploy/macos)\n\n### 一键部署脚本 (推荐)\n\n```bash\nsudo -E bash -c \"$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/quick_start_x_napcat.sh)\"\n```\n\n## 🖥️ 开发者资源\n\n如果你想为 NekroAgent 项目贡献，或想在 NekroAgent 基础上定制自己的功能，请参考：\n\n- [插件开发指南(施工中)](https://doc.nekro.ai/docs/04_plugin_dev/01_concepts/architecture)\n- [应用开发指南](https://doc.nekro.ai/docs/05_app_dev/dev_linux)\n\n注意：贡献代码前请先阅读[许可说明](./LICENSE)中的条款，贡献代码即表示您同意这些条款。\n\n## 📖 常见问题\n\n常见问题及解答请访问 [故障排除与 FAQ](https://doc.nekro.ai/docs/06_troubleshooting/faq)\n\n## 🎉 更新日志\n\n前往 [Release 页面](https://github.com/KroMiose/nekro-agent/releases) 查看重要更新日志\n\n## 📜 许可说明\n\nNekroAgent 采用 [自定义的开源协议](./LICENSE)（基于 Apache License 2.0 修改）进行分发。请在遵守协议的前提下使用本项目！\n\n## 🤝 贡献列表\n\n感谢以下开发者对本项目做出的贡献\n\n\u003ca href=\"https://github.com/KroMiose/nekro-agent/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=KroMiose/nekro-agent\u0026max=1000\" /\u003e\n\u003c/a\u003e\n\n## ⭐ Star 历史\n\n![Star History Chart](https://api.star-history.com/svg?repos=KroMiose/nekro-agent\u0026type=Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkromiose%2Fnekro-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkromiose%2Fnekro-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkromiose%2Fnekro-agent/lists"}