# InitRunner > InitRunner is an open-source CLI tool for creating and running AI agents from YAML configuration files. InitRunner lets you define AI agents as YAML role files and run them from the terminal. It supports multiple LLM providers, tools, memory, RAG, guardrails, and multi-agent orchestration. ## Getting Started - [Introduction](https://initrunner.ai/docs): InitRunner — define AI agents as YAML, run them from the terminal. - [Quickstart](https://initrunner.ai/docs/quickstart): Get your first AI agent running in under five minutes. - [Chat](https://initrunner.ai/docs/chat): Zero-config chat, role-based REPL, and one-command bot launching. - [Telegram Bot](https://initrunner.ai/docs/telegram): Get a Telegram bot agent running in three steps. - [Discord Bot](https://initrunner.ai/docs/discord): Get a Discord bot agent running in five steps. - [Role Creation](https://initrunner.ai/docs/role-creation): Every way to create an InitRunner agent role — AI generation, interactive wizard, templates, examples, dashboard, and manual YAML. - [RAG in 5 Minutes](https://initrunner.ai/docs/rag-quickstart): Get a retrieval-augmented generation agent running in three commands. - [Memory in 5 Minutes](https://initrunner.ai/docs/memory-quickstart): Give any agent persistent memory — sessions that resume, facts that stick, and rules that accumulate — in minutes. - [Setup Wizard](https://initrunner.ai/docs/setup): Guided wizard to configure your model provider, API key, and first agent role. - [Examples](https://initrunner.ai/docs/examples): Discover, clone, and run 25+ example agent configurations from the CLI, or browse detailed walkthroughs on this page. - [Installation](https://initrunner.ai/docs/installation): Install InitRunner via pip, uv, pipx, the quick install script, or Docker. - [Docker](https://initrunner.ai/docs/docker): Run InitRunner in Docker without installing Python — images, compose, volumes, and build options. - [Cloud Deploy](https://initrunner.ai/docs/cloud-deploy): One-click deployment to Railway, Render, and Fly.io — get the InitRunner dashboard running in the cloud in minutes. - [Tutorial: Build a Site Monitor Agent](https://initrunner.ai/docs/tutorial): Build a complete site monitor agent step by step, using every major InitRunner feature. - [Tutorial: Dev Workflow Agents](https://initrunner.ai/docs/dev-workflow-agents): Run three pre-built templates — PR reviewer, changelog for Slack, and CI failure explainer — each producing copy-paste-ready output. ## Core Concepts - [Concepts & Architecture](https://initrunner.ai/docs/concepts): High-level mental model of InitRunner — the role file, runtime architecture, execution lifecycle, and safety layers. - [Configuration](https://initrunner.ai/docs/configuration): Full YAML schema reference for InitRunner agent roles. - [Intent Sensing](https://initrunner.ai/docs/intent-sensing): Auto-select the right agent from your library using the --sense flag. - [Providers](https://initrunner.ai/docs/providers): Supported LLM providers and model configuration. - [Ollama & Local Models](https://initrunner.ai/docs/ollama): Run agents with local LLMs using Ollama or any OpenAI-compatible endpoint — zero API keys required. ## Agent Capabilities - [Tools](https://initrunner.ai/docs/tools): Tool types and configuration reference for InitRunner agents. - [Skills](https://initrunner.ai/docs/skills): Reusable capability bundles that add tools and prompt instructions to agents. - [Memory](https://initrunner.ai/docs/memory): Session persistence and long-term memory (semantic, episodic, procedural) with automatic consolidation for InitRunner agents. - [Ingestion](https://initrunner.ai/docs/ingestion): Document ingestion and RAG pipeline for InitRunner agents. - [RAG Patterns & Guide](https://initrunner.ai/docs/rag-guide): Practical patterns for using InitRunner's retrieval-augmented generation (RAG) capabilities. - [Multimodal Input](https://initrunner.ai/docs/multimodal): Send images, audio, video, and documents alongside text prompts across CLI, REPL, API, and dashboard. - [Autonomous Mode](https://initrunner.ai/docs/autonomy): Plan-execute-adapt loops for agents that work without human intervention. - [Structured Output](https://initrunner.ai/docs/structured-output): Return validated JSON from agents using JSON Schema definitions. - [Report Export](https://initrunner.ai/docs/reports): Export structured markdown reports from any agent run, capturing prompt, output, token usage, timing, and status. ## Automation & Orchestration - [Triggers](https://initrunner.ai/docs/triggers): Cron schedules, file watchers, webhooks, heartbeat, Telegram, and Discord triggers for autonomous agent execution. - [Sinks](https://initrunner.ai/docs/sinks): Output destinations for daemon and compose agent runs. - [Team Mode](https://initrunner.ai/docs/team-mode): Define multiple personas in a single YAML file for sequential multi-agent collaboration. - [Compose](https://initrunner.ai/docs/compose): Multi-agent orchestration with delegate sinks and startup ordering. ## Safety & Observability - [Guardrails](https://initrunner.ai/docs/guardrails): Token budgets, tool limits, and automatic enforcement for safe agent execution. - [Security](https://initrunner.ai/docs/security): Security hardening guide for InitRunner agents. - [Docker Sandbox](https://initrunner.ai/docs/docker-sandbox): Run shell, Python, and script tools inside isolated Docker containers with kernel-level network, filesystem, and resource isolation. - [Audit Trail](https://initrunner.ai/docs/audit): SQLite audit logging, export, redaction, and pruning for InitRunner agent runs. - [Observability](https://initrunner.ai/docs/observability): OpenTelemetry distributed tracing for InitRunner agent runs, LLM requests, tool calls, and multi-agent pipelines. - [Testing](https://initrunner.ai/docs/testing): Test suites, dry-run mode, and validation for InitRunner agents. - [Agent Evals](https://initrunner.ai/docs/evals): Define eval suites in YAML and run them against agent roles to verify output quality, tool usage, performance, and cost. ## Interfaces - [Dashboard & TUI](https://initrunner.ai/docs/dashboard): Terminal and web interfaces for monitoring and interacting with InitRunner agents. - [CLI Reference](https://initrunner.ai/docs/cli): Complete command reference for the InitRunner CLI. - [API Server](https://initrunner.ai/docs/server): Serve any agent as an OpenAI-compatible HTTP API. - [MCP Gateway](https://initrunner.ai/docs/mcp-gateway): Expose InitRunner agents as MCP tools for Claude Desktop, Claude Code, Cursor, and other MCP clients. ## Community - [Registry](https://initrunner.ai/docs/registry): Install, share, and manage community roles from the InitRunner registry. ## Help - [Doctor](https://initrunner.ai/docs/doctor): Check your InitRunner environment — API keys, provider SDKs, and service connectivity — with a single command. - [Troubleshooting & FAQ](https://initrunner.ai/docs/troubleshooting): Common issues, error messages, and frequently asked questions for InitRunner.