README

!Nexent Banner








Nexent 是一个基于 Harness Engineering 原则打造的零代码智能体自动生成平台。集统一工具、技能、记忆和编排能力于一体，内置约束机制、反馈循环和控制平面。无需编排，无需复杂的拖拉拽操作，使用纯语言开发你想要的任何智能体。

 一个提示词，无限种可能。


  
  查看演示视频


 🚀 先来试试看

 ⭐ 在您开始使用前，请您顺手在 GitHub 为我们点个 Star，您的支持是我们前进的动力！

 自行部署

如果需要在本地或私有环境中部署 Nexent，我们提供两种部署方式：

 系统要求

| 资源 | Docker 部署 | Kubernetes 部署 |
|------|------------|----------------|
| CPU | 4 核（最低）/ 8 核（推荐） | 4 核（最低）/ 8 核（推荐） |
| 内存 | 8 GiB（最低）/ 16 GiB（推荐） | 16 GiB（最低）/ 64 GiB（推荐） |
| 磁盘 | 40 GiB（最低）/ 100 GiB（推荐） | 100 GiB（最低）/ 200 GiB（推荐） |
| 架构 | x86_64 / ARM64 | x86_64 / ARM64 |
| 软件 | Docker 24+, Docker Compose v2+ | Kubernetes 1.24+, Helm 3+ |

 注意： 推荐配置可确保生产环境下的最佳性能。

 Docker 部署（推荐个人/小团队使用）

适用于大多数用户，快速简单。部署前需准备Docker 24+, Docker Compose v2+：

bash
git clone https://github.com/ModelEngine-Group/nexent.git
cd nexent
bash deploy.sh docker


根目录 deploy.sh 只负责转发到目标部署脚本；Docker 真实实现为 bash deploy/docker/deploy.sh。Docker 和 Kubernetes 使用同一套部署配置模型；交互式运行会通过 Bash TUI 选择组件、端口策略和镜像源。infrastructure 必选，application、data-process 默认选中，也可以取消以部署更小的组合。使用 --defaults 可跳过 TUI，并复用已保存的 deploy.options 或内置默认值。非交互部署也可传入 --version、--components、--port-policy development|production、--image-source general|mainland|local-latest。

历史账号升级和故障恢复统一参见迁移与排障手册。

Docker 与 Kubernetes 统一使用 deploy/env/.env 作为运行配置文件；已有 deploy/env/.env 会原样保留。如果 deploy/env/.env 不存在，部署脚本会优先复用已有的 docker/.env，再回退到 deploy/env/.env.example。监控相关配置会从 deploy/env/monitoring.env.example 生成到 deploy/env/monitoring.env。

Docker 卸载入口为 bash uninstall.sh docker，默认交互确认是否删除持久化数据；也可以通过 --delete-volumes true|false 控制，或使用 bash uninstall.sh docker delete-all 同时删除容器和持久化数据。

离线镜像包可通过 bash build.sh --package --target docker --compress true 或 bash deploy/offline/build_offline_package.sh --target docker --compress true 构建。包内包含镜像 tar、load-images.sh、push-images.sh、根目录部署/卸载入口、部署脚本、SQL 文件、manifest.yaml 和 checksums.txt。包内部署会复用已保存的 deploy.options 或内置默认值，默认不进入 TUI；添加 --config 可交互配置。在目标机器上使用 bash deploy.sh --load-images docker ... 加载镜像并部署，或使用 bash deploy.sh --push-images --image-registry-prefix registry.example.com/nexent docker ... 推送到内部仓库并使用该镜像前缀部署。启用 --push-images 且未传前缀时，deploy.sh 会先询问镜像仓库前缀，随后 push-images.sh 询问仓库账号和密码。

详细部署指南请参考 Docker 安装部署。

 Kubernetes 部署（适合企业级生产环境）

适用于需要高可用、弹性扩展的企业场景。部署前需准备 Kubernetes 集群（1.24+）和 Helm 3+：

bash
git clone https://github.com/ModelEngine-Group/nexent.git
cd nexent
bash deploy.sh k8s


Kubernetes 真实实现为 bash deploy/k8s/deploy.sh。它会先安装仅包含 Elasticsearch、PostgreSQL、Redis、MinIO 的 nexent-infrastructure Helm release，在基础组件和 Elasticsearch API Key 就绪后，再安装应用侧 nexent release。可通过 --release-scope all|infrastructure|nexent 部署两侧或单独一侧。脚本会读取同一个 deploy/env/.env 并渲染 Helm ConfigMap 和 Secret 覆盖值；PVC 可通过 --persistence-mode local|dynamic|existing、--storage-class/--sc、--local-path、--local-node-name、--existing-claim-prefix 控制。

根目录卸载入口为 bash uninstall.sh docker ... 或 bash uninstall.sh k8s ...。Kubernetes 默认先卸载 nexent、再卸载 nexent-infrastructure；也可使用相同的 --release-scope 单独卸载，并对基础 release 执行依赖保护。

Kubernetes 离线包使用同一个构建脚本，传入 --target k8s 或 --target all。部署前需要在每个