Welcome to Sunny Agents SDK

The Sunny Agents SDK is a TypeScript/JavaScript library designed specifically for building healthcare applications. Embed AI-powered chat experiences that help patients find providers, book appointments, get health information, and navigate care—all in real-time.

Quick links

Core capabilities

Build rich chat experiences with these integrated capabilities:

What you can build

• Healthcare concierge applications - Help patients find in-network providers and book appointments instantly
• Provider search interfaces - Enable patients to search for doctors by specialty, location, and availability
• Health information assistants - Provide reliable health information and support 24/7
• Appointment booking systems - Streamline appointment scheduling with AI-powered guidance
• Benefits navigation tools - Help employees and members understand and access their healthcare benefits

Get your credentials

Before integrating, you need a public key and partner identifier from Sunny Central, the partner portal. Sign in at platform.sunnyhealthai.com (or staging) and go to Developer Tools to create an API key and view your partner name.

Installation

Get started in seconds:

$
npm install @sunnyhealthai/agents-sdk
$
# or
$
pnpm add @sunnyhealthai/agents-sdk
$
# or
$
yarn add @sunnyhealthai/agents-sdk

Integration

Use createSunnyChat to embed a fully-featured chat widget with automatic authentication and server-driven configuration:

1
import { createSunnyChat } from "@sunnyhealthai/agents-sdk";
2
3
const chat = createSunnyChat({
4
  container: document.getElementById("chat"),
5
  partnerIdentifier: "acme-health",
6
  publicKey: "pk-sunnyagents_abc_xyz",
7
  authType: "passwordless", // or "tokenExchange"
8
});
9
10
// Access the client for programmatic control
11
chat.client.on("snapshot", (snapshot) => { /* ... */ });
12
13
// Clean up when done
14
chat.destroy();

Get support

Have questions or need help? We’re here for you:

• Documentation issues - Open an issue on GitHub
• General support - Email our team
• TypeScript types - Full type definitions included