如何用 Nixified AI 安装并运行一个 AI 项目?

更新时间

在已安装 Nix 包管理器的前提下，用一条 nix 命令即可安装并运行 nixified.ai 仓库中的 AI 项目，Linux 各发行版和 Windows（通过 WSL）都适用。前提是：目标项目已被仓库打包；你没有修改源码（否则会触发本地从源码构建）；GPU 加速需要 NVIDIA 或 AMD 显卡及对应驱动。nixified.ai 本身不提供容器镜像，而是把每个 AI 项目打包成自包含的 Nix 包，用 Nix 的依赖隔离机制替代容器运行时。

它解决的是什么问题

直接跑一个 AI 项目，常见卡点是依赖版本冲突、系统库缺失、CUDA/ROCm 环境对不上。nixified.ai 的做法是：每个项目连同全部依赖一起打包为 Nix 包，构建过程可复现，并且从源码构建，因此同一份代码在不同机器上得到一致结果。它不使用容器，所以不需要 Docker 或虚拟机层。

操作步骤

1. 安装 Nix 包管理器

这是唯一的前置条件。按 Nix 官方安装方式在你的 Linux 发行版上装好 Nix；Windows 用户先启用 WSL，再在 WSL 内安装 Nix。仓库页面提到可配合 NixOS-WSL 在 WSL 中运行 GPU 加速负载。

2. 找到目标项目的运行命令

仓库以 “Packaged Projects” 列出已打包项目，每个项目对应一条 nix 运行命令。页面上没有逐条列出命令文本，实际命令需在仓库项目条目或 GitHub 仓库中查看。

3. 执行命令并观察结果

输入：项目对应的 nix run 类命令。 动作：Nix 解析依赖，优先从 cachix.org 的二进制缓存拉取已构建好的产物。 预期结果：命令直接启动该 AI 程序，无需你手动编译。

4. 验证是否走了缓存

正常情况下不应出现长时间编译输出。如果看到大量 building 行，说明当前产物不在缓存中或你改动了源码，此时会转为本地从源码构建——这仍然能成功，只是耗时明显变长。

关键机制：为什么通常不用编译

nixified.ai 的 CI（Hercules CI）在代码构建完成后把结果推送到 cachix.org。Nix 的 “Binary Substitution” 机制让客户端优先下载这些预构建二进制，行为类似传统二进制分发。因此：

情况 行为 耗时
未修改源码，缓存命中 直接下载二进制 短
修改了源码或缓存缺失 本地从源码构建全部依赖 长
缓存基础设施不可用 仍可本地完整复现 长

最后一行是这个设计的关键价值：即使缓存服务消失，你依然能在本地重建全部内容，可复现性不依赖某台服务器长期存在。

环境与硬件条件

  • 操作系统：任意 Linux 发行版；Windows 需 WSL。
  • GPU：支持 NVIDIA 和 AMD GPU，需自行准备好驱动；仓库未说明具体驱动版本要求。
  • 磁盘与网络：首次拉取二进制需要下载体积不小的产物，具体大小页面未给出。
  • 源码定制：高级用户可按任意粒度修改构建过程，代价是失去缓存、转为本地构建。

常见卡点与处理

  • 命令跑成编译：确认没有改动源码；确认网络能访问 cachix.org。
  • GPU 不可用：检查 WSL 场景下是否按 NixOS-WSL 的方式配置；原生 Linux 下检查驱动是否被 Nix 环境识别。
  • 项目不在列表中：仓库是开源项目，可在 GitHub 提 issue 请求打包或自行贡献打包。
  • 需要帮助：页面提供 Contact、GitHub、Chat 三个入口，问题可走 GitHub issue 或聊天渠道。

适合谁用

适合想跳过环境配置、直接运行 AI 项目，并且在意长期可复现的人；也适合愿意为社区贡献打包的开发者。如果你需要容器化部署流水线，或需要仓库未收录的项目，这个方案不能直接满足——前者要另找容器方案，后者要先解决打包问题。