humanlayer/12-factor-agents

What are the principles we can use to build LLM-powered software that is actually good enough to put in the hands of production customers?

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 43 minutes ago
Added to GitGenius on September 2nd, 2026
Created on March 30th, 2025
Open Issues & Pull Requests: 27 (+0)
GitHub issues: Enabled
Number of forks: 1,957
Total Stargazers: 25,746 (+0)
Total Subscribers: 219 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 18.6 days
Mean response time: 28.7 days
90th percentile: 50.3 days
Tracked items: 12

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 15
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 318 days
Stale 30+ days: 13
Stale 90+ days: 12

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • version::1.1 (2)
  • help wanted (1)
  • not-relevant (1)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

12-factor-agents is a framework for building production-ready LLM-powered software using principles adapted from twelve-factor application methodology.

The project addresses the challenge of creating reliable, maintainable AI agents by applying established software engineering practices to LLM-based systems. It translates the twelve-factor methodology—originally designed for scalable web applications—into principles suited to agent development. This approach helps developers structure their AI systems in ways that prioritize reliability, testability, and operational soundness rather than treating agents as experimental prototypes.

Teams building production AI systems should consider this framework if they need guidance on moving beyond proof-of-concept implementations. It suits projects where LLM agents must integrate into customer-facing applications and require the same rigor as traditional software. The framework is particularly relevant for teams familiar with twelve-factor principles who want to apply that discipline to agent development, providing a bridge between established software engineering practices and the emerging patterns of AI systems.

The project shows active development with regular commits addressing core framework concerns. The codebase demonstrates ongoing refinement of how twelve-factor principles map to agent-specific challenges like context-window management, memory handling, and prompt engineering. The maintainers are actively exploring the intersection of established software practices and LLM orchestration through iterative improvements to the framework's guidance and implementation patterns.