Build AI agents and web apps — with a single binary.
Find a file
Max 01daa783e0 feat(chat): improve error handling for chat operations
- Added centralized error handling for "not found" scenarios in GetChat, UpdateChat, DeleteChat, and GetMessages functions, enhancing user feedback for missing resources.
- Introduced isNotFoundError and respondNotFound utility functions to streamline error responses across chat-related operations.
- Updated the setting package to include new endpoints for setup status and user preferences, improving API functionality and user experience.
2026-05-04 21:53:26 +08:00
.github fix(workflows): streamline release process for Linux and macOS 2026-04-24 09:11:29 +08:00
agent feat(messenger): enhance dynamic SMTP resolution and identity handling 2026-05-04 18:15:21 +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 feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +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 feat(logging): enhance logger output control and add trace diagnostics 2026-04-28 10:37:04 +08:00
commercial feat(licenses): implement machine ID binding for license validation 2026-03-27 17:18:17 +08:00
config feat(search): refactor builtinSearch to utilize websearch tool and enhance context handling 2026-05-02 19:58:03 +08:00
connector fix setup bugs 2023-05-18 15:28:22 +08:00
crypto feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +08:00
cui ⚠️ BREAKING: Rename XGen to CUI and update license terms 2025-05-18 12:16:45 +08:00
data fix(tests): temporarily disable KB/DB search in tests 2026-05-03 10:26:06 +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(llm): refactor audio capabilities and enhance role management 2026-04-30 12:33:05 +08:00
event Enhance subscription management by adding cancel functions and improving channel handling 2026-02-24 00:22:08 +08:00
excel feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +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): enhance MCP handler with gRPC authorization support 2026-05-03 19:57:26 +08:00
helper feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +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
llmprovider fix(tests): update provider key handling in TestOwnerPrefixedIDs 2026-05-03 21:46:55 +08:00
mcp Refactor MCP client handling for improved categorization and information display 2025-12-05 14:17:56 +08:00
mcpclient feat(load): add initialization and reloading for Setting Registry 2026-04-28 15:08:22 +08:00
messenger feat(messenger): enhance dynamic SMTP resolution and identity handling 2026-05-04 18:15:21 +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 feat(agent): enhance system configuration and connector management 2026-05-01 10:31:58 +08:00
openapi feat(chat): improve error handling for chat operations 2026-05-04 21:53:26 +08:00
pack [add] pack & start command support license 2023-04-23 10:57:28 +08:00
pipe feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +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 feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +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 feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +08:00
service fix(tests): improve error handling in unit tests and Makefile 2026-04-06 17:17:11 +08:00
setting feat(messenger): enhance dynamic SMTP resolution and identity handling 2026-05-04 18:15:21 +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 feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +08:00
store Refactor Context Management to Use Memory Instead of Space 2025-12-22 11:19:00 +08:00
sui feat(sandbox): add opencode runner and enhance attachment processing 2026-04-24 23:26:55 +08:00
tai feat(sandbox): add sandbox management endpoints and data structures 2026-04-29 18:47:38 +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
tools feat(agent): enhance image content handling and vision support 2026-05-04 13:46:30 +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 feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +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 feat(doc): add yao doc CLI commands and YAML documentation for all packages 2026-04-23 21:37:43 +08:00
workspace feat(workspace): add workspace ID retrieval and integration into environment configuration 2026-04-13 14:47:08 +08:00
yao fix(tests): temporarily disable KB/DB search in tests 2026-05-03 10:26:06 +08:00
.gitignore feat(agent): enhance sandbox V2 initialization and role management 2026-05-03 19:11:29 +08:00
go.mod feat(agent): enhance image content handling and vision support 2026-05-04 13:46:30 +08:00
go.sum chore(deps): update spdystream dependency to v0.5.1 and adjust model version in tests 2026-04-23 22:27:39 +08:00
LICENSE chore(license): remove deprecated commercial license documents 2026-05-04 18:43:07 +08:00
LICENSE.zh-CN chore(license): remove deprecated commercial license documents 2026-05-04 18:43:07 +08:00
main.go feat(search): refactor builtinSearch to utilize websearch tool and enhance context handling 2026-05-02 19:58:03 +08:00
Makefile feat(sandbox): add sandbox management endpoints and data structures 2026-04-29 18:47:38 +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.