llm-agents.nix

用 Nix 一键装齐 AI 编程代理，版本锁定每天自动更新

llm-agents.nix 是一个用 Nix 打包 AI 编程代理与开发工具的开源仓库，核心目标是把 Claude Code、Aider、Gemini CLI 等快速迭代的 AI 编码工具变成可复现、可锁定版本的 Nix 包。它解决的是 AI 工具更新频繁、依赖复杂、跨机器环境不一致的问题：用户无需手动下载二进制或配置 Node/Python 环境，只需在 Nix flake 中引入即可获得固定版本的代理工具。项目每天自动更新包定义，保证能跟进上游最新版本，同时借助 Nix 的纯函数式构建实现可回滚、可审计的安装。它适合已经使用 Nix 或 NixOS 的开发者，把 AI 代理纳入声明式开发环境，与 home-manager、devenv 等工具链自然集成。

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1969

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开发框架

开发团队numtide

所属国家

官网地址https://numtide.github.io/llm-agents.nix

GitHubhttps://github.com/numtide/llm-agents.nix

定价模式free

价格说明开源免费，Nix包管理工具

访问状态

是否开源是

开源协议MIT

主要语言Nix

技术栈/模型

GitHub 星标★ 1969

30天Star增速

HF 下载量

上线时间2025-07-18 00:00:00

最近更新2026-09-18 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-16

浏览次数0

使用教程

难度：进阶约 10 分钟部署方式：命令行工具 6 步

环境要求

已安装 Nix（README 中所有命令均为 nix 命令）
能够访问 GitHub（命令直接从 github:numtide/llm-agents.nix 拉取）
了解 nix run / nix develop 的基本用法
部分工具为 unfree 许可证，需允许非自由软件

安装与启动步骤

1准备 Nix 环境

README 未提供 Nix 本身的安装步骤，请先按 Nix 官方文档在系统中安装并确认 nix 命令可用。
2浏览全部工具

运行交互式启动器，会打开 fzf 选择器列出所有包及其描述，选中后通过 nix run 执行。
```
nix run github:numtide/llm-agents.nix
```
3直接运行工具

也可以跳过选择器，用 #工具名直接运行指定工具，例如 claude-code、opencode、gemini-cli、qwen-code。
```
nix run github:numtide/llm-agents.nix#claude-code
```
4查看工具参数

README 中各工具的 Usage 都以 -- --help 形式给出，-- 之后的参数会传给工具本身。
```
nix run github:numtide/llm-agents.nix#agentty -- --help
```
5进入开发环境

若要在本仓库上进行开发，可在仓库目录中进入其提供的 Nix 开发环境。
```
nix develop
```
6运行仓库检查

执行 flake 检查，验证仓库定义是否正常，适合修改后自测。
```
nix flake check
```

如何确认成功

命令成功拉起 fzf 选择器并能运行所选工具，或 `nix run ...#工具名 -- --help` 正常输出该工具的帮助信息。

常见问题

Q：必须使用 NixOS 吗？

A：不必须。README 中所有操作均为 nix run / nix develop / nix flake check 命令，任何安装了 Nix 的系统都可使用。

Q：怎么知道仓库里有哪些工具？

A：直接运行 nix run github:numtide/llm-agents.nix，会打开 fzf 选择器列出每个包及其描述，也可在官网查看生成文档。

Q：这些工具是源码构建还是直接下载二进制？

A：README 中每个工具都标注了 Source，取值为 source（源码构建）或 binary（二进制），可按此判断。

Q：提示许可证不被允许怎么办？

A：README 中标注为 unfree 的工具（如 amp、antigravity-cli）需要在 Nix 配置中允许非自由软件后才能安装运行。

注意事项

README 中每个工具的 Usage 均为 `nix run github:numtide/llm-agents.nix#<工具名> -- --help` 形式。
包定义每天自动更新，可跟进上游最新版本，并借助 Nix 实现可回滚、可审计的安装。
部分工具（amp、antigravity-cli）许可证为 unfree，使用前需注意合规与配置。
README 未提供 Nix 自身的安装命令，需另行参考 Nix 官方文档。

核心亮点

每天自动更新包定义，能紧跟 Claude Code、Aider 等上游工具的最新版本
基于 Nix 实现版本锁定与可复现构建，换机器或回滚版本只需改一行配置
覆盖多个主流 AI 编程代理，统一在一个 flake 中管理，避免逐个手动安装

不足之处

仅面向 Nix 用户，非 Nix 环境无法直接使用，受众相对垂直
部分工具上游更新过快，自动更新偶尔可能滞后或需要手动干预修复

适用场景

NixOS 或 macOS 上用 home-manager 声明式安装并固定 AI 编程代理版本
团队统一开发环境，让所有成员使用相同版本的 AI 编码工具
在 CI 或临时容器中快速拉起带 AI 代理的隔离开发环境

替代项目

nixpkgs、devenv、mise

项目介绍

llm-agents.nix 是一个开发框架领域的开源项目，官方简介：Nix packages for AI coding agents and development tools. Automatically updated daily.。项目使用 Nix 开发，在 GitHub 上获得 1941 星标。

上一篇：instructor

下一篇：llm4s