// the find
YaoApp/yao
✨ Build AI agents and web apps — with a single binary.
Yao is a Go binary that tries to be an all-in-one runtime: AI agent framework, database ORM, REST API server, server-side rendering engine, and chat UI — all configured via JSON/YAML with TypeScript hooks running in an embedded V8. The pitch is that you describe your app declaratively and the binary handles everything else. It targets teams who want to ship AI-powered apps without assembling a stack from scratch.
The test suite is unusually thorough for an AI framework project — integration tests, unit tests, stress tests, and e2e tests exist across nearly every package, which is not what you expect from something in this space. The embedded V8 for TypeScript hooks is a real design win: you get programmable hook logic without requiring Node.js on the host. The CLI Agent mode — running Claude Code or OpenCode in an isolated container with VNC desktop support — is a concrete answer to the computer-use problem rather than hand-waving at it. The 'cage not animal' hook model (Create before, Next after) is architecturally honest about where determinism needs to live when you wrap a non-deterministic LLM.
The single-binary-does-everything design means you're adopting Yao's opinions on data modeling, routing, UI rendering, and agent lifecycle all at once — integrating it with an existing stack is essentially not an option, you're rewriting around it. The main docs live on yaoagents.com rather than in the repo, which is a maintenance and discoverability liability; if that site goes down or the project pivots, the knowledge walks out the door. The project has visible identity drift — it started as a low-code platform and bolted AI on, so you're carrying a lot of non-agent surface area (SUI pages, table models, REST mapping) even if all you want is the agent runtime. With 7,500 stars and only 686 forks, community depth is thin; issues and discussion appear split between English and Chinese, which can create friction when you hit edge cases and need help.