DriftlessAF is Chainguard's foundational agentic framework for building AI-powered automation and resilient GitHub reconcilers.
This project includes the following Go modules and functionality.
- AI executors: Production-ready executors for Google Gemini and Anthropic Claude models.
- Evaluation framework: Testing and monitoring agent quality with comprehensive metrics.
- OpenTelemetry metrics: Built-in observability for AI operations.
- Prompt building: Utilities for constructing and managing prompts.
- Tool calling: Helpers for function/tool calling with Claude and Gemini.
- Result parsing: Structured output extraction from model responses.
Find more information in the agents README.
Production-ready reconciler infrastructure based on the Kubernetes reconciliation pattern, adapted for GitHub automation:
- Workqueue system: GCS-backed state persistence with retry, exponential
backoff, and concurrency control (
workqueue/). Find more information in the workqueue README. - Reconcilers: Process GitHub pull requests, repository file paths, APK
packages, and OCI artifacts (
reconcilers/). Find more information in the reconciler README.
go get chainguard.dev/driftlessaf@latestSee the package documentation for examples and the API reference.
See the examples README for more information.
This repository contains two Go modules — the root chainguard.dev/driftlessaf
library and the chainguard.dev/driftlessaf/examples module. Build and test each
from its own directory.
Go 1.25.8 or newer is required, as specified in both go.mod files.
Root library:
go build ./...
go test ./...Examples:
cd examples
go build ./...
go test ./...