# Ductile

> An automation runtime designed to be operated by AI agents.

Ductile is a self-hosted automation runtime designed to be operated
by AI agents. You describe a goal in natural language; your AI agent
authors a YAML pipeline, runs it, watches the logs, and iterates
until your goal is met. A single Go binary orchestrates polyglot
plugins via a JSON-over-stdin/stdout subprocess protocol; every
surface (NOUN ACTION CLI, REST API with OpenAPI discovery, queryable
execution ledger) is shaped so an LLM can drive it. Sized for
personal-scale automation (50–500 jobs/day).


## Introduction

- [Getting Started](https://ductile.run/GETTING_STARTED/index.md)
- [8 Idioms of Ductile](https://ductile.run/8_IDIOMS_OF_DUCTILE/index.md)
- [Glossary](https://ductile.run/GLOSSARY/index.md)
- [Audiences](https://ductile.run/AUDIENCES/index.md)

## Concepts

- [Architecture](https://ductile.run/ARCHITECTURE/index.md)
- [Pipelines](https://ductile.run/PIPELINES/index.md)
- [Routing](https://ductile.run/ROUTING_SPEC/index.md)
- [Scheduler](https://ductile.run/SCHEDULER/index.md)
- [Plugin Facts](https://ductile.run/PLUGIN_FACTS/index.md)

## Building

- [Cookbook](https://ductile.run/COOKBOOK/index.md)
- [Plugin Development](https://ductile.run/PLUGIN_DEVELOPMENT/index.md)
- [Webhooks](https://ductile.run/WEBHOOKS/index.md)
- [YAML Tips](https://ductile.run/YAML_TIPS/index.md)

## Operating

- [Deployment](https://ductile.run/DEPLOYMENT/index.md)
- [Operator Guide](https://ductile.run/OPERATOR_GUIDE/index.md)
- [Health Check](https://ductile.run/HEALTH_CHECK/index.md)
- [Plugin Diagnostics](https://ductile.run/PLUGIN_DIAGNOSTICS/index.md)
- [Remote Event Relay](https://ductile.run/REMOTE_EVENT_RELAY/index.md)

## Reference

- [Config](https://ductile.run/CONFIG_REFERENCE/index.md)
- [API](https://ductile.run/API_REFERENCE/index.md)
- [Database](https://ductile.run/DATABASE/index.md)
- [Testing](https://ductile.run/TESTING/index.md)

## For Agents

- [Overview](https://ductile.run/for-agents/index.md)
- [Operator Handbook](https://ductile.run/for-agents/operator-handbook/index.md)