@ryuhq/client

  @ryu/client

Typed TypeScript client for the Ryu Core HTTP API. Part of Ryu.

@ryu/client is a Mastra-style typed client over Ryu Core's HTTP API (:7980): create a client, pick an agent, and stream. It has no internal Ryu dependencies and zero runtime dependencies. It uses native fetch and works in Node 18+, Bun, Deno, and modern browsers. It pairs with the open Core.

Tier: OSS, Apache-2.0

Install / Build

bun add @ryu/client
# build from source
bun run build   # tsup → dist/

What it provides

• createRyuClient / RyuClient (client.ts): entry point and typed options (RyuClientOptions).
• Agents API (agents.ts, AgentsAPI): list and address agents, stream chat (StreamChunk).
• Sessions API (sessions.ts, SessionsAPI): conversations and messages (Conversation, Message).
• Spaces API (spaces.ts, SpacesAPI): Spaces / RAG retrieval (Space, SpaceMatch).
• Transport (request.ts, types.ts): the native-fetch request layer and shared types.

License

Apache-2.0. See LICENSE. 2026 A Major Pte. Ltd.