Introduction

Open-Source AI Agent CLI

InitRunner is an open-source CLI that turns a YAML file into a complete AI agent. Define the model, tools, and behavior in a single role.yaml — InitRunner handles the rest: tool execution, guardrails, memory, RAG, and multi-provider routing. No framework to learn, no boilerplate to write.

Key Features

Define

• YAML-first — Declare agents with a Kubernetes-style apiVersion/kind/metadata/spec schema. Readable, portable, version-controllable.
• Multi-provider — OpenAI, Anthropic, Google, Groq, Mistral, and Ollama. Swap providers by changing one line.
• 14 tool types — Filesystem, HTTP, MCP, shell, SQL, custom Python, and more. Give agents the capabilities they need.

Remember

• Built-in RAG — Ingest documents, chunk, embed, and vector-search with sqlite-vec. No external database required.
• Memory — Short-term session persistence and long-term semantic recall across conversations.

Automate

• Triggers — Run agents on a cron schedule, file change, or incoming webhook. Daemon mode included.
• Multi-agent compose — Orchestrate multiple agents with delegate sinks and startup ordering.
• Autonomy — Plan-execute-adapt loops that let agents work through multi-step tasks independently.

Ship

• API server — initrunner serve exposes any agent as an OpenAI-compatible API with streaming.
• TUI + Web dashboard — Monitor, inspect, and interact with agents visually.
• Guardrails & audit — Token budgets, tool limits, content filtering, PII redaction, and full action logging to SQLite.

Quick Install

pip install initrunner

Or use the install script:

curl -fsSL https://initrunner.ai/install.sh | sh

Next Steps

• Quickstart — Get your first agent running in minutes
• Concepts & Architecture — High-level mental model, diagrams, and execution lifecycle
• Examples — Complete, runnable agents for common use cases
• Installation — All install methods, extras, and platform notes
• Configuration — Full YAML schema reference
• Providers — Provider setup and model configuration
• Tools — All 14 tool types
• Memory — Session persistence and semantic memory
• Ingestion — Document ingestion and RAG
• Triggers — Cron, file watch, and webhook triggers
• Autonomy — Autonomous plan-execute-adapt loops
• Guardrails — Token budgets, tool limits, and automatic enforcement
• CLI — Complete CLI reference
• Security — Security hardening guide
• Compose — Multi-agent orchestration
• API Server — OpenAI-compatible HTTP API
• Troubleshooting & FAQ — Common issues and frequently asked questions