Skip to main content
pragma-os manages infrastructure through three core concepts: resources, providers, and reactive dependencies.

​
Core Concepts

Resources

Infrastructure components — AI models, agents, storage buckets, secrets — that you declare and pragma-os provisions.

Providers

Components that manage specific resource types, handling creation, updates, and deletion.

Reactive Dependencies

When one resource changes, dependent resources automatically update through the dependency graph.

​
Resources

A resource is an infrastructure component — an AI agent, a language model, a secret, a storage bucket. You declare resources in YAML: 
provider: agno
resource: agent
name: assistant
config:
  model:
    provider: agno
    resource: anthropic-model
    name: claude
  instructions: "You are a helpful assistant."
pragma-os creates the agent, tracks its state, and manages its lifecycle. Resources can reference each other’s outputs through field references and dependency declarations.

​
Providers

Providers manage specific resource types. pragma-os includes providers for AI infrastructure, cloud platforms, and container orchestration.
Manages AI agent infrastructure:
  • Language models (Anthropic, OpenAI)
  • Agents with tools and instructions
  • Multi-agent teams
  • Knowledge bases and vector storage
  • Persistent memory and storage
You never interact with providers directly. You declare resources, and pragma-os routes them to the right provider automatically.

​
Reactive Dependencies

Infrastructure components depend on each other — an AI agent needs a language model, which needs an API key secret. pragma-os tracks these dependencies and propagates changes automatically. 
provider: agno
resource: agent
name: assistant
config:
  model:
    provider: agno
    resource: anthropic-model
    name: claude
1

You update a resource

The claude model’s configuration changes.
2

pragma-os detects the change

The dependency graph identifies that assistant depends on claude.
3

Dependents automatically update

The assistant agent receives the updated model and rebuilds.
Changes propagate through your infrastructure dependency graph automatically. You can apply resources in any order — pragma-os resolves dependencies and processes resources when their requirements are met.

​
Real-Time Visibility

The web UI provides a live graph view of your resources and their dependencies. Resource state changes stream in real-time, so you can watch your infrastructure converge as resources move through their lifecycle states.

​
Learn More

Resources

Learn how to declare and configure infrastructure components.

Providers

Understand how providers manage resources.

Reactive Dependencies

See how changes propagate through your infrastructure.
For an introduction to what pragma-os offers, see Learn More.