AIAny
AI Agent2025
Icon for item

12-Factor Agents — Principles for building reliable LLM applications

Twelve engineering principles for building production-grade LLM agents, modeled on the 12-Factor App. Argues the best agents are mostly deterministic software with a few well-placed LLM calls, not a prompt-and-tools loop.

Introduction

Most agent frameworks get you to an 80% demo fast, then strand you — and the last 20% of reliability is exactly where production customers live. The bet here is counterintuitive: the agents that actually ship aren't autonomous loops at all, but mostly ordinary software with a handful of LLM calls placed precisely where judgment is genuinely needed.

Core Argument
  • Treat the twelve factors as a menu, not a religion. Each one — own your prompts, small focused agents, agent as a stateless reducer, trigger from anywhere — is a standalone pattern you graft onto existing code, so you gain control without rewriting your product around a framework.
  • Make the model's boundaries explicit. "Own your context window" means you decide exactly which tokens the LLM sees instead of trusting a framework's hidden serialization, and "tools are just structured outputs" reframes tool use as the model emitting JSON your deterministic code acts on — so every handoff between LLM and system stays inspectable, testable, and versioned.
  • Humans are a tool call, not an afterthought. "Contact humans with tool calls" plus launch/pause/resume APIs turn agents into durable, resumable workflows instead of fragile chat sessions that die on the first ambiguous step.
Who It's For + Tradeoffs

Great fit if you're a builder dragging an LLM feature from impressive demo to dependable production, and you want vendor-neutral patterns you can adopt piecemeal. Look elsewhere if you want a turnkey framework or an installable library — this is a set of principles, diagrams, and TypeScript examples, not a package, and it assumes you're comfortable owning your own control flow.

Information

  • Websitegithub.com
  • OrganizationsHumanLayer
  • AuthorsHumanLayer (Dex Horthy)
  • Published date2025/03/30

More Items

Provides a large corpus of runnable 3D programs and a multi-agent harness that generates, executes, measures, visually judges, and repairs executable 3D code to produce editable, verifiable 3D scenes. Includes ~269K runnable programs, 2.03M render–caption pairs, and an automated execution+repair pipeline.

GitHub
AI Agent2026

Runs persistent, self-hosted AI teammates that retain conversation, memory, routines and a sandboxed browser/shell. Supports bring-your-own models, local or remote sandbox providers, voice, team computers and integrations for auditable, controllable agent workflows.

GitHub
AI Agent2026

Lets an AI agent control a real or cloud phone by tapping, typing, scrolling and reading the screen. Works with iPhone via macOS iPhone Mirroring, Android over adb, or rented cloud phones; host-side OCR, accessibility trees and CLI helpers provide verifiable UI actions without jailbreaking. Some manual phone pairing/setup is required.