---
name: "Build bounded single-binary agent workflows with Yao"
slug: "build-bounded-single-binary-agent-workflows-with-yao"
description: "Use Yao when an operator needs to package an AI agent workflow, hooks, MCP tools, memory scopes, and a reviewable web or chat interface into one deployable runtime."
github_stars: 7543
verification: "security_reviewed"
source: "https://github.com/YaoApp/yao"
author: "YaoApp"
publisher_type: "open_source"
category: "Templates & Workflows"
framework: "Custom Agents"
tool_ecosystem:
  github_repo: "YaoApp/yao"
  github_stars: 7543
---

# Build bounded single-binary agent workflows with Yao

Use Yao when an operator needs to package an AI agent workflow, hooks, MCP tools, memory scopes, and a reviewable web or chat interface into one deployable runtime.

## Prerequisites

Yao single-binary runtime, a Yao project definition, TypeScript hooks, optional MCP tools, optional CLI agent executor, and a model provider configured according to the upstream docs.

## Installation

Requirements and caveats from upstream:
- **TypeScript** — Built-in V8 engine; no Node.js required
- **Single Binary** — Runs on ARM64/x64; no Python, Node, or containers needed on the host

Basic usage or getting-started notes:
- **CLI Agent / Sandbox** — Run Claude Code (or other CLI runners) in an isolated container with VNC desktop support

- Source: https://github.com/YaoApp/yao
- Extracted from upstream docs: https://raw.githubusercontent.com/YaoApp/yao/HEAD/README.md

## Documentation

- https://yaoagents.com/docs

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/build-bounded-single-binary-agent-workflows-with-yao/)