ainfra

Documentation

Learn how to install, configure, and use ainfra for reviewable infrastructure lifecycle operations.

Start with Introduction for an overview, use Installation to install a verified release, or go directly to Quick Start for the first local workflow.

Introduction

ainfra turns reusable infrastructure templates into repeatable, reviewable deployments. It validates explicit contracts, …

Quick Start

The current alpha CLI can validate a local deployment, lock a local or Git template source, create a reviewed OpenTofu …

Installation

ainfra publishes archives for Linux and macOS on amd64 and arm64. The official installer detects the current platform, …

Configuration

ainfra combines immutable, typed configuration layers without changing a deployment or template. From lowest to highest …

Output, inventory, and Ansible

Validate OpenTofu output and configure hosts from a reviewed run.

Hetzner private K3s template

Phase 9 ships the live-certified provider-backed production candidate at templates/hetzner-kubernetes-baseline in …

Usage

The current alpha CLI validates local contracts, diagnoses deployments, resolves immutable local or Git template …

Guarded MCP server

ainfra can serve its typed application operations to MCP clients over stdio. The server is bound to one deployment at …

Templates

Templates are self-contained, reviewable infrastructure environments for specific AI-agent workloads. Phase 8 defines …

AI template-authoring guide

This is the self-contained execution entry point for an AI agent authoring an ainfra v1 template. It is a conformance …

Reviewed OpenTofu Plans

ainfra separates OpenTofu planning from infrastructure mutation. plan creates a private saved plan and immutable review …

References

Doctor commands# text Copy ainfra doctor [TARGET] ainfra doctor all [TARGET] ainfra doctor environment ainfra doctor …

Tutorials

Validate a template in a clean room#Copy the reference template, make only the required local edits, then run: sh Copy …

Contributing

Contributions to ainfra should begin with the repository’s contribution and security guidance. The complete …

Roadmap

The ainfra v1 roadmap begins with the core lifecycle and expands through hardening, templates, integrations, and release …