{"id":"27790a1e-49d8-4e57-9528-b177c081cb4a","entityType":"agent","slug":"crewai-bottlelee-crewai-playbook","name":"crewai-playbook","canonicalUrl":"https://www.xpersona.co/agent/crewai-bottlelee-crewai-playbook","canonicalPath":"/agent/crewai-bottlelee-crewai-playbook","generatedAt":"2026-10-10T00:57:13.930Z","source":"GITHUB_REPOS","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T20:22:15.298Z","emptyReason":null},"description":"**Ansible-compatible YAML playbook orchestrator for [crewAI](https://crewai.com) agents.** crewai-playbook $1 $1 $1 $1 **Ansible-compatible YAML playbook orchestrator for $1 agents.** Write declarative YAML playbooks — just like Ansible — to orchestrate multi-agent AI workflows. Define agents in a static inventory, compose plays with tasks, blocks, handlers, and roles, then execute locally or in your CI pipeline. --- Installation Requires Python 3.10+ and a running $1 instance (or any OpenAI-compatible API","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 10/9/2026.","installCommand":null,"sourceUrl":"https://github.com/bottlelee/crewai-playbook","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/bottlelee/crewai-playbook","kind":"source"}],"safetyScore":66,"overallRank":18.2,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"**Ansible-compatible YAML playbook orchestrator for [crewAI](https://crewai.com) agents.** crewai-playbook $1 $1 $1 $1 **Ansible-compatible YAML playbook orches"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T20:22:15.298Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"crewai","status":"self-declared"},{"label":"multi-agent","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":3,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"crewai","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"multi-agent","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:crewai|supported|profile capability:multi-agent|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-10-09T20:22:15.298Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":1,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-10-09T20:22:15.293Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T20:22:15.298Z","lastCrawledAt":"2026-10-09T20:22:15.293Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-16T20:22:15.293Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB REPOS","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":null,"setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_REPOS","generatedAt":"2026-10-10T00:57:13.929Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-bottlelee-crewai-playbook/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB REPOS","verified":false,"confidence":"high","updatedAt":"2026-10-09T20:22:15.298Z","emptyReason":null},"readme":"# crewai-playbook\n\n[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://python.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)\n[![Tests](https://img.shields.io/badge/tests-106%20passing-brightgreen)](tests/)\n[![CLI](https://img.shields.io/badge/CLI-typer-8A2BE2)](https://typer.tiangolo.com)\n\n**Ansible-compatible YAML playbook orchestrator for [crewAI](https://crewai.com) agents.**\n\nWrite declarative YAML playbooks — just like Ansible — to orchestrate multi-agent AI workflows. Define agents in a static inventory, compose plays with tasks, blocks, handlers, and roles, then execute locally or in your CI pipeline.\n\n```yaml\n# playbook.yml\n- name: Research & Writing Pipeline\n  agents: [manager, researcher, writer, reviewer]\n  vars:\n    topic: \"Artificial Intelligence\"\n  tasks:\n    - name: Research the topic\n      agents: [researcher]\n      task: 'Research \"{{ topic }}\" and provide key findings'\n```\n\n```bash\ncrewai-playbook run playbook.yml -i config/agents.yaml\n```\n\n---\n\n## Installation\n\n```bash\npip install crewai-playbook\n# or with uv\nuv pip install crewai-playbook\n```\n\nRequires Python 3.10+ and a running [Ollama](https://ollama.com) instance (or any OpenAI-compatible API).\n\n### Quick Start\n\n```bash\n# Scaffold a new project\ncrewai-playbook init my-project\ncd my-project\n\n# Define agents in config/agents.yaml\n# Write a playbook in playbooks/\n\n# Validate syntax\ncrewai-playbook lint playbooks/research.yml -i config/agents.yaml\n\n# Dry-run (no LLM calls)\ncrewai-playbook run playbooks/research.yml -i config/agents.yaml --check\n\n# Execute\ncrewai-playbook run playbooks/research.yml -i config/agents.yaml\n\n# Override variables\ncrewai-playbook run playbooks/research.yml -i config/agents.yaml -e \"topic=Quantum Computing\"\n```\n\n---\n\n## Features\n\n| Feature | Description |\n|---------|-------------|\n| **YAML-driven** | Declarative playbooks — no Python coding required |\n| **Familiar syntax** | Mirrors Ansible: plays, tasks, blocks, handlers, roles, vars |\n| **Dry-run** | `--check` previews planned actions without LLM calls |\n| **Hierarchical mode** | Leader agent delegates work to sub-agents (crewAI `Process.hierarchical`) |\n| **Sequential mode** | Tasks run in order, one agent at a time |\n| **Variable templating** | `{{ var }}` interpolation in task descriptions, `src`/`dest` paths |\n| **Extra vars** | `-e key=value` or `-e '{\"key\":\"val\"}'` — highest precedence |\n| **Block/Rescue/Always** | Error handling with fallback agents and cleanup tasks |\n| **Handlers + Notify** | Deferred actions triggered by task output |\n| **Tags** | `--tags` / `--skip-tags` for selective execution |\n| **Agent groups** | `@group` syntax in `--limit` and play agent lists |\n| **Roles** | Reusable task collections in `roles/<name>/tasks/main.yml` |\n| **Gather facts** | Automatic environment introspection (`gather_facts: true`) |\n| **Syntax check** | `--syntax-check` validates YAML and variable references |\n| **Lint** | `lint` command checks play names, agents, role references |\n| **Scaffold** | `init` creates a complete project directory structure |\n| **Ollama ready** | Built-in `ollama/` LLM prefix resolution — no cloud API needed |\n\n---\n\n## CLI Reference\n\n### `run` — Execute a playbook\n\n```bash\ncrewai-playbook run [OPTIONS] PLAYBOOK\n```\n\n| Flag | Description |\n|------|-------------|\n| `--check` | Dry-run, no LLM calls |\n| `--diff` | Show expected file diffs (with `--check`) |\n| `--syntax-check` | Validate YAML + variable refs, then exit |\n| `--list-tasks` | Print all tasks and exit |\n| `--list-tags` | Print all tags and exit |\n| `--tags TEXT` | Only run tasks with these tags (repeatable) |\n| `--skip-tags TEXT` | Skip tasks with these tags (repeatable) |\n| `--limit TEXT` | Limit to specific agents (`name` or `@group`) |\n| `-e`, `--extra-vars TEXT` | Extra variables (`key=value` or JSON) |\n| `-v` | Verbosity (stackable: `-v`, `-vv`) |\n| `-i`, `--inventory TEXT` | Agent inventory path (default: `config/agents.yaml`) |\n\n### `init` — Scaffold a project\n\n```bash\ncrewai-playbook init [PATH]\n```\n\n### `lint` — Validate a playbook\n\n```bash\ncrewai-playbook lint [OPTIONS] PLAYBOOK\n```\n\n| Flag | Description |\n|------|-------------|\n| `-i`, `--inventory TEXT` | Agent inventory path |\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `OLLAMA_BASE_URL` | `http://localhost:11434/v1` | Ollama / OpenAI-compatible endpoint |\n| `CREWAI_PLAYBOOK_INVENTORY` | `config/agents.yaml` | Default inventory path |\n| `CREWAI_PLAYBOOK_CONFIG` | — | Project config path |\n\n---\n\n## Supported LLM Providers\n\n| Provider | Spec | Example |\n|----------|------|---------|\n| OpenAI | `gpt-4`, `gpt-4o`, … | `llm: \"gpt-4o\"` |\n| Ollama | `ollama/<model>` | `llm: \"ollama/gemma4:latest\"` |\n\nSet `OLLAMA_BASE_URL` to point at any OpenAI-compatible endpoint (Ollama, vLLM, etc.).\n\n---\n\n## Agent Inventory\n\nDefine agents in `config/agents.yaml`:\n\n```yaml\nagents:\n  researcher:\n    role: \"Research Specialist\"\n    goal: \"Find and synthesize relevant information\"\n    backstory: \"Expert researcher with years of experience.\"\n    llm: \"ollama/gemma4:latest\"\n    groups: [\"default\", \"research\"]\n\n  manager:\n    role: \"Project Manager\"\n    goal: \"Coordinate agents and delegate tasks\"\n    backstory: \"Experienced team lead.\"\n    leader: true\n    groups: [\"default\"]\n```\n\n---\n\n## Project Layout\n\n```\nmy-project/\n├── config/\n│   └── agents.yaml              # Agent definitions\n├── playbooks/\n│   └── research.yml             # Your playbooks\n├── roles/\n│   └── <name>/\n│       ├── defaults/\n│       │   └── main.yml         # Default variables\n│       └── tasks/\n│           └── main.yml         # Role task definitions\n└── crewai-playbook.yml          # Project config (optional)\n```\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/<your-user>/crewai-playbook.git\ncd crewai-playbook\n\n# Install in editable mode\npip install -e .\n\n# Run tests\npip install pytest\npytest -v\n\n# Build wheel\npip install build\npython -m build\n```\n\nAll 106+ tests validate:\n- Playbook parsing (syntax, structure, variables)\n- Executor orchestration (sequential, hierarchical, tags, limits)\n- Task execution (retry, until, when, register, src/dest)\n- Block/rescue/always error handling\n- Handler/notify lifecycle\n- Role loading and variable precedence\n- CLI flags and scaffold generation\n\n---\n\n## Why crewai-playbook?\n\nIf you know Ansible, you already know how to orchestrate crewAI agents. The same mental model applies:\n\n| Ansible | crewai-playbook |\n|---------|----------------|\n| `hosts:` | `agents:` |\n| `tasks:` | `tasks:` |\n| `block:`/`rescue:`/`always:` | `block:`/`rescue:`/`always:` |\n| `handlers:`/`notify:` | `handlers:`/`notify:` |\n| `roles:` | `roles:` |\n| `vars:` | `vars:` |\n| `gather_facts:` | `gather_facts:` |\n| `-e` extra vars | `-e` extra vars |\n| `--check` | `--check` |\n| `--tags`/`--skip-tags` | `--tags`/`--skip-tags` |\n| `--limit` | `--limit` |\n\n---\n\n## License\n\n[MIT](LICENSE)\n","readmeExcerpt":"crewai-playbook $1 $1 $1 $1 **Ansible-compatible YAML playbook orchestrator for $1 agents.** Write declarative YAML playbooks — just like Ansible — to orchestrate multi-agent AI workflows. Define agents in a static inventory, compose plays with tasks, blocks, handlers, and roles, then execute locally or in your CI pipeline. --- Installation Requires Python 3.10+ and a running $1 instance (or any OpenAI-compatible API","codeSnippets":[],"executableExamples":[{"language":"yaml","snippet":"# playbook.yml\n- name: Research & Writing Pipeline\n  agents: [manager, researcher, writer, reviewer]\n  vars:\n    topic: \"Artificial Intelligence\"\n  tasks:\n    - name: Research the topic\n      agents: [researcher]\n      task: 'Research \"{{ topic }}\" and provide key findings'"},{"language":"bash","snippet":"crewai-playbook run playbook.yml -i config/agents.yaml"},{"language":"bash","snippet":"pip install crewai-playbook\n# or with uv\nuv pip install crewai-playbook"},{"language":"bash","snippet":"# Scaffold a new project\ncrewai-playbook init my-project\ncd my-project\n\n# Define agents in config/agents.yaml\n# Write a playbook in playbooks/\n\n# Validate syntax\ncrewai-playbook lint playbooks/research.yml -i config/agents.yaml\n\n# Dry-run (no LLM calls)\ncrewai-playbook run playbooks/research.yml -i config/agents.yaml --check\n\n# Execute\ncrewai-playbook run playbooks/research.yml -i config/agents.yaml\n\n# Override variables\ncrewai-playbook run playbooks/research.yml -i config/agents.yaml -e \"topic=Quantum Computing\""},{"language":"bash","snippet":"crewai-playbook run [OPTIONS] PLAYBOOK"},{"language":"bash","snippet":"crewai-playbook init [PATH]"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["python"],"docsSourceLabel":"GITHUB REPOS","editorialOverview":"**Ansible-compatible YAML playbook orchestrator for [crewAI](https://crewai.com) agents.** crewai-playbook $1 $1 $1 $1 **Ansible-compatible YAML playbook orchestrator for $1 agents.** Write declarative YAML playbooks — just like Ansible — to orchestrate multi-agent AI workflows. Define agents in a static inventory, compose plays with tasks, blocks, handlers, and roles, then execute locally or in your CI pipeline. --- Installation Requires Python 3.10+ and a running $1 instance (or any OpenAI-compatible API","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":366,"uniquenessScore":67,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T20:22:15.298Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T20:22:15.298Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T00:57:13.930Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_repos","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}