AgentENV

一行命令拉起上千个 Agent 沙箱环境

开源 unknown 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3616

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类基础设施

开发团队kvcache-ai

所属国家

官网地址

GitHubhttps://github.com/kvcache-ai/AgentENV

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型

GitHub 星标★ 3616

30天Star增速

HF 下载量

上线时间2026-07-23 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-12

浏览次数0

项目介绍

AgentENV（AENV）是一个用 Rust 编写的分布式平台，专门用于大规模运行 AI Agent 环境。随着智能体应用从单机 Demo 走向生产，如何同时拉起、隔离、调度成百上千个带浏览器、终端、文件系统的执行环境成为瓶颈。AENV 把每个 Agent 环境做成可编排的分布式单元，提供统一 API 来创建、快照、恢复和销毁环境，并支持跨节点调度与资源隔离。它解决的是 Agent 运行时的基础设施问题：环境生命周期管理、并发扩展、状态持久化和故障恢复，让开发者不必自己拼容器编排和沙箱。核心能力包括分布式环境编排、环境快照与回滚、资源配额控制，以及面向 Agent 框架的接入层。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：进阶约 10 分钟部署方式：本地安装 5 步

环境要求

Linux 或 macOS 系统（x86_64 或 arm64）
需要 sudo / root 权限（安装、启动 systemd 服务）
选择 Docker 方式需已安装 Docker，容器需以 --privileged 运行并挂载 /dev
服务端必须运行在可信网络内（API 只认证不加密）

安装与启动步骤

1安装并启动服务端

方式 A：安装脚本会同时装好服务端和 aenv CLI，并把服务端注册为 systemd 服务，安装后需手动启动。
```
curl -fsSL https://raw.githubusercontent.com/kvcache-ai/AgentENV/main/scripts/install.sh | sudo bash
sudo systemctl start aenv
```

2或用 Docker 启动

方式 B：与方式 A 二选一。先跑环境准备脚本，再拉取服务端镜像，以特权模式运行并映射 8000 端口。

curl -fsSL https://raw.githubusercontent.com/kvcache-ai/AgentENV/main/scripts/docker-setup.sh | sudo bash
docker pull ghcr.io/kvcache-ai/aenv-server:latest
docker run -d --name aenv-server --privileged -v /dev:/dev -p 8000:8000 ghcr.io/kvcache-ai/aenv-server:latest

3安装 aenv CLI

用 Docker 方式安装服务端，或 CLI 与服务端不在同一台机器时，需单独安装 CLI；支持 Linux/macOS 的 x86_64 与 arm64。
```
curl -fsSL https://raw.githubusercontent.com/kvcache-ai/AgentENV/main/scripts/install-cli.sh | bash
```
4获取 API Key

服务端首次启动时会自动生成 API Key，按上一步选择的安装方式读取对应文件。
```
# 原生安装
sudo cat /var/lib/aenv/secrets/api-key

# Docker
docker exec aenv-server cat /workspace/env/secrets/api-key
```
5认证 CLI

运行 aenv auth，在提示处粘贴上一步取到的 API Key 完成认证。
```
aenv auth
```

关键配置

配置项	必填	说明	示例
`API Key`	是	服务端首次启动自动生成，CLI 认证时使用	`sudo cat /var/lib/aenv/secrets/api-key`
`服务端口`	否	服务端默认监听端口，Docker 方式映射到宿主机 8000	`8000`

如何确认成功

访问 http://127.0.0.1:8000 有响应，且执行 aenv auth 填入 API Key 后认证通过。

常见问题

Q：不用 Docker，只想装 CLI 可以吗？

A：可以。使用 Docker 方式装服务端，或 CLI 与服务端不在同一机器时，都单独执行 install-cli.sh 安装 CLI 即可。

Q：API Key 去哪里找？

A：服务端首次启动时生成：原生安装读取 /var/lib/aenv/secrets/api-key，Docker 方式执行 docker exec aenv-server cat /workspace/env/secrets/api-key。

Q：生产环境能直接暴露服务端吗？

A：不能。AgentENV 只认证 API 请求但不加密流量，请部署在可信网络内，或在反向代理/负载均衡上终止 HTTPS。

Q：多节点 / 集群怎么部署？

A：README 只给出了单节点快速开始，Docker Compose、Kubernetes 集群部署及源码编译请查阅官方 Deployment 文档。

注意事项

API 请求只做认证不做加密，切勿在不可信明文网络中传输 API Key。
Docker 方式以 --privileged 运行并挂载 /dev，请确认宿主机允许该权限。
CLI 支持 Linux 和 macOS 的 x86_64 与 arm64，Windows 未在 README 中提及。
Docker Compose / Kubernetes 部署与源码编译见官方文档 kvcache-ai.github.io/AgentENV。

核心亮点

Rust 实现，启动快、内存占用低，适合高密度并发环境
原生分布式调度，支持跨节点创建和迁移 Agent 环境
提供环境快照与恢复，便于复现和调试 Agent 执行过程

不足之处

项目较新，生产环境大规模验证案例有限
生态集成和文档完善度仍在早期阶段

适用场景

批量评测和对比多个 Agent 在相同环境下的表现
为编码 Agent 提供隔离的终端与文件系统沙箱
在 CI 中并行运行大量 Agent 任务并回收环境

替代项目

E2B、Daytona

上一篇：CF-Workers-TGProxy

下一篇：agent-sandbox