tensorchord/envd

这是什么？

核心功能

• 01在 Python 格式的 build.envd 文件中定义环境，通过 envd up 启动。
• 02生成兼容 OCI 规范的镜像，可推送到容器镜像仓库。
• 03同一环境可在本地或 Kubernetes 集群中运行。
• 04在多次构建间缓存 pip 和 apt 下载内容，并支持远程构建。
• 05通过 include 函数从 Git 仓库导入可复用的函数。

适用场景

• 为模型训练或微调搭建可复现的 Python 与 CUDA 环境。
• 用几行构建配置快速启动 Jupyter Notebook 环境。
• 通过镜像仓库在团队内共享统一的开发环境。
• 将镜像构建转移到性能更强的远程机器上完成。

快速上手

1. 1

   使用 pip 安装 envd

   pip install --upgrade envd
2. 2

   初始化 envd

   envd bootstrap
3. 3

   克隆快速入门仓库

   git clone https://github.com/tensorchord/envd-quick-start.git
4. 4

   构建并进入环境

   cd envd-quick-start && envd up

使用前须知

• !运行需要 Docker 20.10.0 或更高版本。
• !从 v1.0 起 build.envd 默认语法为 v1，旧的 v0 示例可能需要升级。

标签

常见问题

envd 是什么？

一款命令行工具，通过 Python 编写的 build.envd 文件构建可复现的容器化 AI/ML 开发环境。 envd 是一款命令行工具，用于创建面向 AI 和机器学习工作的容器化开发环境。你在用 Python 编写的 build.envd 文件中声明所需的软件包、语言运行时和服务，再执行 envd up 即可构建并启动环境。安装 CUDA 相关工具、Python 包、Jupyter 和 shell 等步骤都以函数调用的形式描述，无需手写 Dockerfile 或 shell 脚本。

envd 可以免费使用吗？用的什么许可证？

envd 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

envd 还在维护吗？

活跃维护中。envd 最近一次提交是在 2026年11月2日。

envd 适合用来做什么？

为模型训练或微调搭建可复现的 Python 与 CUDA 环境。 用几行构建配置快速启动 Jupyter Notebook 环境。 通过镜像仓库在团队内共享统一的开发环境。 将镜像构建转移到性能更强的远程机器上完成。

envd 怎么安装和运行？

使用 pip 安装 envd: pip install --upgrade envd 初始化 envd: envd bootstrap 克隆快速入门仓库: git clone https://github.com/tensorchord/envd-quick-start.git 构建并进入环境: cd envd-quick-start && envd up

在哪里获取 envd？

源代码和安装说明在 GitHub 上：https://github.com/tensorchord/envd