12-Factor Agents

A set of principles for building LLM powered software intended for production users.

github.com/humanlayer/12-factor-agents
12-Factor Agents homepage screenshot

About 12-Factor Agents

12-Factor Agents is a public repository outlining a set of 12 principles for building LLM-powered software suitable for production customer use, modeled after the 12 Factor Apps framework for traditional software development. The principles cover core engineering practices including natural language to tool call translation, prompt and context ownership, structured tool outputs, unified state management, human-in-the-loop tooling, error handling, and stateless agent design, with the goal of improving the reliability, scalability, and maintainability of LLM applications.

Key features

  • 12 core principles for production LLM application development
  • Guidance for converting natural language to tool calls
  • Best practices for owning prompts and context windows
  • Frameworks for unifying execution and business state
  • Patterns for human-in-the-loop agent tooling
  • Guidance for building small, focused stateless agents
Best for: AI engineers and founders building production-facing LLM agent applications.
Good for
  • Principles derived from testing existing popular agent frameworks
  • Fills gap in guidance for production customer-facing LLM agents
  • Outlines practices to improve LLM application reliability and maintainability
Watch out for
  • Principles are still being refined via community feedback
  • Does not provide pre-built implementation tools or frameworks
  • Focused on high-level principles, not specific tooling integrations

12-Factor Agents at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Not stated
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

12-Factor Agents alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in AI Agents & Automation

Well-known listings from the same topic.

All 313

12-Factor Agents FAQ

What is 12-Factor Agents?
A set of principles for building production-ready LLM-powered software, inspired by the 12 Factor Apps framework.
What topics do the 12 factors cover?
The factors cover prompt ownership, context management, state handling, human-in-the-loop tooling, error compaction, and stateless agent design, among other practices.
Is 12-Factor Agents a ready-to-use agent framework?
No, it is a set of high-level guidance and principles for building LLM applications, not a pre-built framework.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing