Awesome Ryu

A curated list of awesome things built with and around Ryu, the open-core orchestration and control layer for AI agents.

Ryu is the whole stack around AI agent engines: it sits above every model and harness as the orchestration (Core) and governance (Gateway) layer. BYO everything, zero lock-in. This list collects the official components, clients, SDKs, agents, tools, and community projects in the Ryu ecosystem.

Contents

• Official
• Clients & Extensions
• SDKs & Libraries
• Agents
• Tools & MCP Servers
• Engines
• Skills
• Learning & Docs
• Community

Official

• Ryu: the open-core monorepo, with the orchestration engine (Core), LLM gateway (Gateway), CLI, desktop-automation and capture sidecars, and the developer SDK.
• Documentation: guides, the Gateway/Core reference, and interactive OpenAPI playgrounds.
• Open-core boundary: what's open, what's closed, and why.

Clients & Extensions

• Ryu for Raycast: Ask Ryu (one-shot), Chat with Ryu (multi-turn), and Search Conversations, straight from Raycast (macOS + Windows). MIT
• Ryu CLI: a ratatui terminal client for Core, covering chat, sidecar management, sessions, and LAN node discovery. Apache-2.0

SDKs & Libraries

• @ryu/sdk: Ryu's Runnable-native dev SDK, with defineAgent / defineWorkflow / defineTool / defineSkill, a gateway-mandatory model client, and MCP server/client. Apache-2.0
• create-ryu-app: scaffold a new Ryu app/plugin with bunx create-ryu-app <name>. Apache-2.0
• @ryu/client: a typed TypeScript client for the Core HTTP API. Apache-2.0

Agents

Engines Ryu orchestrates over the Agent Client Protocol (ACP). Each is a swappable slot, none is hardcoded:

• Ryu (the flagship): Pi with the Gateway on top, installed by default.
• Pi, Claude Code, Codex, Gemini CLI, OpenClaw, and Hermes, plus ~18 more ACP agents available opt-in from the catalog.

Tools & MCP Servers

• Ghost: desktop-automation MCP server (screen perception + input control). Dual-use, consent-gated. Apache-2.0
• Shadow: screen/audio/input capture, OCR, and semantic search. Dual-use, consent-gated. Apache-2.0

Engines

Local and remote inference runtimes Ryu can drive (all swappable defaults):

• llama.cpp (default, with Gemma 4), Ollama, vLLM, SGLang, and MLX on Apple Silicon.

Skills

• Agent Skills: Ryu speaks the Agent Skills standard and can browse + install skills from skills.sh (shared with Claude Code via ~/.claude/skills).

Learning & Docs

• Self-hosting Ryu: build Core + Gateway and point any OpenAI-compatible client at the Gateway.

Community

• Discord
• X / Twitter

Contributing

Contributions welcome! Built something with Ryu, such as an agent, skill, MCP server, integration, or guide? Open a pull request adding it to the relevant section. Please keep entries to one line, in alphabetical order within a section, and link to a real, working resource.

License

To the extent possible under law, A Major Pte. Ltd. has waived all copyright and related or neighboring rights to this curated list.