照着做，LLM 应用从 Demo 稳健走向生产
12-factor-agents 是一套用于构建生产级 LLM 应用的指导性原则，借鉴了经典的 12-Factor App 方法论，针对 AI 代理（Agent）软件的特殊性进行了重新定义。它解决了当前 LLM 应用开发中缺乏系统性工程规范、难以从原型走向稳定生产的问题。项目以简洁的文档形式，提出了 12 条核心原则，涵盖代码库、依赖、配置、后端服务、构建发布、进程、端口、并发、可处置性、开发生产环境一致性、日志、管理任务等方面，并针对 AI 场景进行了适配，例如强调可观测性、可测试性、安全性和成本控制。其核心能力在于提供一套可落地的工程实践指南，帮助开发者构建更可靠、可维护、可扩展的 LLM 应用，避免常见的“演示易、生产难”困境。
⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。
1克隆原则仓库
把 12-factor-agents 仓库拉到本地，方便离线阅读全部原则文档。README 未提供其他安装包或脚手架命令。
git clone https://github.com/humanlayer/12-factor-agents.git2进入仓库目录
进入克隆下来的目录，准备查看 README 与 content/ 下的逐条原则说明。
cd 12-factor-agents3阅读上下文窗口原则
README 明确指向 factor-03-own-your-context-window.md，先读这条最常被引用的原则。
cat content/factor-03-own-your-context-window.md4观看讲解视频
README 提供两个 AI Engineer World's Fair 的 Deep Dive 视频链接，适合快速理解整体思路。
5查看贡献讨论
README 提到 npx/uvx create-12-factor-agent 的讨论帖，如需参与或了解进展可前往 Discussions。
执行 git clone 后能看到 README.md 与 content/ 目录，且能打开 content/factor-03-own-your-context-window.md 即表示获取成功。
Q：这个项目需要安装依赖或启动服务吗？
A：不需要。仓库本身是原则性文档集合，README 未给出任何安装、构建或启动命令，直接阅读即可。
Q：有现成的 npm 脚手架可以用吗？
A：README 仅在贡献说明中提及 npx/uvx create-12-factor-agent 并指向讨论帖，尚未给出正式发布与使用命令，请关注该讨论。
Q：讲解视频在哪里看？
A：README 顶部提供两个 YouTube Deep Dive 链接（8kMaTybvDUw、yxJDyQ8v6P0），可直接在浏览器打开观看。
Q：如何参与或反馈？
A：README 表示欢迎反馈与贡献，可通过 GitHub 仓库的 Discussions 讨论帖参与。
12-factor-app、LLM Engineering Guidelines、AI Engineering Best Practices
12-factor-agents 是智能体领域的开源项目，由 humanlayer 开发，2025 年首次发布。
在全站 13,014 个收录项目中，它的 GitHub 星标数（26,354）位列前 2%，在智能体分类的 2,499 个项目里位列前 3%。
近 41 天，它的 GitHub 星标从 25,267 增加到 26,354，净增 1,087。
项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。无在线服务，需自行部署，完全免费。
它主要面向的使用场景是：从原型验证走向生产部署的LLM应用开发。同类可对比的替代方案包括 12-factor-app、LLM Engineering Guidelines、AI Engineering Best Practices。
下一篇：DB-GPT
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望，让交互更真实
独立、可自托管的 AI 动态心智状态引擎：驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木，拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工，交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
EvoAgentX
开源
让 AI 智能体自己迭代变强，越用越聪明
EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents