Build AI agents and web apps — with a single binary.
Find a file
Max e7bb997e2a docs: update README files to reflect new branding for Yao Desktop
- Changed the label for the desktop app in both English and Chinese README files to "Yao Desktop" for consistency and improved branding.
- Ensured that the visual elements align with the updated terminology across both language versions.
2026-04-21 00:15:12 +08:00
.github fix(workflows): refine release and notarization processes for macOS and Linux 2026-04-19 18:48:06 +08:00
agent feat(robot): enhance DeliveryAttachment structure with size and content type fields 2026-04-14 15:01:05 +08:00
aigc Refactor AIGC ID Handling in Load Function 2025-12-15 12:10:01 +08:00
api Refactor error handling in various components to improve logging and message formatting 2025-09-28 10:24:17 +08:00
assert Implement P3 Run Phase with Enhanced Validation and Execution Logic 2026-01-17 12:22:23 +08:00
attachment Add zip processing functionality for attachments 2026-02-15 12:12:17 +08:00
audit Update dependencies in go.mod and go.sum to latest versions for improved stability and performance 2025-07-13 09:15:54 +08:00
bin Enhance File Handling and Input Parsing in Test Framework 2025-12-25 11:50:58 +08:00
cert fix: Enhance loading functions to handle non-existent directories 2025-05-13 09:10:10 +08:00
cmd fix(workflows): update R2 bucket and asset paths for consistency across workflows 2026-04-19 17:55:14 +08:00
commercial feat(licenses): implement machine ID binding for license validation 2026-03-27 17:18:17 +08:00
config refactor(sandbox): streamline sandbox configuration loading and enhance local execution capabilities 2026-03-18 11:22:08 +08:00
connector fix setup bugs 2023-05-18 15:28:22 +08:00
crypto Add algorithm parameter to HmacWith function 2024-01-27 10:17:48 +08:00
cui ⚠️ BREAKING: Rename XGen to CUI and update license terms 2025-05-18 12:16:45 +08:00
data feat(system): add Vision and Voice capabilities to System configuration 2026-04-10 11:22:18 +08:00
docker fix(workflows): update R2 bucket and asset paths for consistency across workflows 2026-04-19 17:55:14 +08:00
docs docs: update README files for improved formatting and clarity 2026-04-21 00:10:20 +08:00
dsl Refactor Store Management to Replace Badger with Xun 2025-12-22 09:27:32 +08:00
engine feat(job): enhance health checker and data cleaner with panic recovery and graceful shutdown 2026-04-06 12:37:58 +08:00
event Enhance subscription management by adding cancel functions and improving channel handling 2026-02-24 00:22:08 +08:00
excel refactor: Simplify sheet dimension retrieval in Excel processing 2025-05-15 13:02:13 +08:00
flow fix: Enhance loading functions to handle non-existent directories 2025-05-13 09:10:10 +08:00
fs Add seed file system support and deprecate legacy registrations 2025-10-20 10:34:52 +08:00
grpc feat(grpc, openapi): enhance server keepalive settings and improve sorting in responses 2026-03-13 12:08:32 +08:00
helper Refactor captcha handling in tests and core functionality 2025-10-15 15:43:16 +08:00
i18n fix: Enhance loading functions to handle non-existent directories 2025-05-13 09:10:10 +08:00
importer Refactor error handling in various components to improve logging and message formatting 2025-09-28 10:24:17 +08:00
integrations feat(robot): add Weixin integration and enhance existing adapters 2026-03-23 23:47:25 +08:00
job feat(job): enhance health checker and data cleaner with panic recovery and graceful shutdown 2026-04-06 12:37:58 +08:00
kb Refactor Knowledge Base Collection Initialization and Document Retrieval 2026-01-10 12:38:42 +08:00
mcp Refactor MCP client handling for improved categorization and information display 2025-12-05 14:17:56 +08:00
messenger Implement Attachment Support in Email Messaging 2026-01-18 17:05:24 +08:00
model Enhance Execution Record Model and Storage Implementation 2026-01-18 16:38:30 +08:00
monitor feat(robot): enhance manager and execution handling 2026-03-23 17:46:32 +08:00
openai Add audio transcription file handling and related tests 2026-02-10 19:05:29 +08:00
openapi feat(user): implement Device Flow support in OAuth provider configuration 2026-04-14 18:23:30 +08:00
pack [add] pack & start command support license 2023-04-23 10:57:28 +08:00
pipe Refactor error handling in various components to improve logging and message formatting 2025-09-28 10:24:17 +08:00
plugin Refactor error handling in various components to improve logging and message formatting 2025-09-28 10:24:17 +08:00
query fix setup bugs 2023-05-18 15:28:22 +08:00
registry Add Tai SDK tests and update Makefile for Tai integration 2026-03-03 20:49:34 +08:00
rss Add RSS and Sitemap support in main.go imports 2026-02-12 14:30:18 +08:00
runtime feat: Add ConsoleMode configuration to runtime settings 2025-04-04 18:26:35 +08:00
sandbox fix(sandbox): pass explicit user to docker exec for UID-mapped containers 2026-04-13 18:26:41 +08:00
schedule Refactor error handling in various components to improve logging and message formatting 2025-09-28 10:24:17 +08:00
script Refactor assistant script loading and improve error diagnostics 2025-02-24 14:33:04 +08:00
seed Enhance OpenAPI and JSON Parsing Functionality 2025-12-31 11:54:36 +08:00
service fix(tests): improve error handling in unit tests and Makefile 2026-04-06 17:17:11 +08:00
setup Fix endpoint URL formatting to handle default port correctly 2024-11-29 20:50:24 +08:00
share Enhance tool inspection and remove studio configuration 2026-02-14 21:06:59 +08:00
sitemap Add RSS and Sitemap support in main.go imports 2026-02-12 14:30:18 +08:00
store Refactor Context Management to Use Memory Instead of Space 2025-12-22 11:19:00 +08:00
sui feat(middleware): add support for markdown content negotiation and rendering 2026-04-02 18:55:36 +08:00
tai fix(sandbox): pass explicit user to docker exec for UID-mapped containers 2026-04-13 18:26:41 +08:00
task Refactor error handling in various components to improve logging and message formatting 2025-09-28 10:24:17 +08:00
test feat(database): add PostgreSQL support and enhance JSON handling 2026-04-06 02:56:04 +08:00
trace Enhance subscription management by adding cancel functions and improving channel handling 2026-02-24 00:22:08 +08:00
ui [add] XGen v1.0 packing 2022-09-27 23:54:06 +08:00
utils Update Go module dependencies and enhance assistant context management 2025-11-15 10:05:57 +08:00
wework [add] yao.wework.* processes 2023-04-09 21:25:12 +08:00
widget fix: Enhance loading functions to handle non-existent directories 2025-05-13 09:10:10 +08:00
widgets fix(tests): improve error handling in unit tests and Makefile 2026-04-06 17:17:11 +08:00
workspace feat(workspace): add workspace ID retrieval and integration into environment configuration 2026-04-13 14:47:08 +08:00
yao feat(system): add Vision and Voice capabilities to System configuration 2026-04-10 11:22:18 +08:00
.gitignore feat(database): add PostgreSQL support and enhance JSON handling 2026-04-06 02:56:04 +08:00
COMMERCIAL_LICENSE.md ⚠️ BREAKING: Rename XGen to CUI and update license terms 2025-05-18 12:16:45 +08:00
COMMERCIAL_LICENSE.zh-CN.md ⚠️ BREAKING: Rename XGen to CUI and update license terms 2025-05-18 12:16:45 +08:00
go.mod chore(dependencies): update Go module dependencies to latest versions 2026-04-13 23:43:17 +08:00
go.sum chore(dependencies): update Go module dependencies to latest versions 2026-04-13 23:43:17 +08:00
LICENSE ⚠️ BREAKING: Rename XGen to CUI and update license terms 2025-05-18 12:16:45 +08:00
main.go Add job.jsapi import and enhance session handling in goroutine execution 2026-02-12 23:02:22 +08:00
Makefile fix(tests): improve error handling in unit tests and Makefile 2026-04-06 17:17:11 +08:00
README.md docs: update README files to reflect new branding for Yao Desktop 2026-04-21 00:15:12 +08:00
README.zh-CN.md docs: update README files to reflect new branding for Yao Desktop 2026-04-21 00:15:12 +08:00

Yao — App Runtime for the AI Era

Yao is an open-source runtime for building AI agents and web applications — shipped as a single binary.

Mission Control

🏠 Homepage: https://yaoagents.com

📚 Docs: https://yaoagents.com/docs

🖥️ Yao Desktop: https://yaoagents.com/download


How It Works

Think of Yao Agent as a cage, not an animal. What you put inside determines the behavior; the cage keeps it controlled.

Every request flows through the same pipeline:

Pipeline

Create Hook runs before the executor — inject context, enforce constraints, route requests.
Next Hook runs after — validate output, trigger downstream actions, drive multi-step loops.
The AI does the heavy lifting. You define the boundaries.

Three Modes

Mode Executor When to use
LLM OpenAI, Anthropic, etc. Conversational assistants, Q&A, content generation
CLI Agent OpenCode, Claude Code, Codex in a container Computer use, sandbox isolation, SKILL ecosystem
Pure Hook Your own TypeScript code Deterministic logic, routing, menu flows — no AI needed

All three share the same Hook interface. You can mix them freely — route some requests through the LLM, handle others with pure code, all inside a single Create Hook.


Features

Agent Framework

  • TypeScript HooksCreate and Next hooks intercept every request; built-in V8 engine
  • Native MCP Support — Connect tools via process, SSE, or STDIO transport
  • Memory API — Four scopes: request-level, session, user, team
  • Multi-Agent — Delegate to specialist agents or call agents in parallel
  • CLI Agent / Sandbox — Run Claude Code (or other CLI runners) in an isolated container with VNC desktop support
  • Skills Ecosystem — Drop reusable capability packs (SKILL.md) into any CLI Agent

Full-Stack Runtime

Everything in a single executable:

  • Data Models — Define database tables and relations in JSON/YAML
  • REST APIs — Map routes to model queries or TypeScript processors
  • SUI Pages — Component-based web UI with server-side rendering
  • Chat UI (CUI) — Built-in conversation interface for agents
  • TypeScript — Built-in V8 engine; no Node.js required
  • Single Binary — Runs on ARM64/x64; no Python, Node, or containers needed on the host
  • Vector Search — Embeddings with OpenAI or FastEmbed
  • Knowledge Graph — Entity-relationship retrieval
  • GraphRAG — Hybrid vector + graph search

About the Name

Yao (爻, yáo) is the fundamental symbol in the I Ching — the building block of the eight trigrams. Like a binary digit, it has two states. Their combinations describe the patterns of everything.