Suki SDKs

Suki provides npm packages and native client SDKs so you can embed Ambient Clinical Intelligence (ACI) into healthcare applications.

Introduction

Suki SDKs help you build clinical AI into healthcare software for providers, nurses, and other care staff. Ambient documentation, Form filling, and Dictation are the core workflows you can embed in web and mobile apps. Each SDK handles client-side authentication, audio streaming, and session management.

Choose a hosted clinical UI, or a headless SDK when you want to build your own experience. For server-side session setup, webhooks, or note retrieval, use the Suki REST APIs with the SDK.

Features and upgrade requirements vary by SDK. Review the changelog and migration guide before upgrading.

How it works

Each SDK follows the same integration pattern:

Configure authentication
Initialize the SDK
Create or resume a clinical session
Capture audio or user input
Receive clinical output such as transcripts, notes, or completed forms

Authentication

SDK access is available to approved Suki partners. Complete partner onboarding, configure authentication for your integration, and obtain credentials for your environment.

For staging access, production credentials, or rollout help, contact your Suki partnership representative or Support.

Get Started Authentication

Installation Commands

Support & Best Practices

SDK support

support@suki.ai

Best practices

Store partnerId, partnerToken, and issued tokens securely; rotate credentials per your security policy.
Request microphone permission before capture starts; handle denial and prompts clearly in your UI.
Send SDK traffic over HTTPS; surface authentication failures and network errors using the patterns in each SDK guide.
Test across devices, OS versions, and network conditions before production rollout.
Always use the latest versions of the SDKs to get the latest features and bug fixes.

Languages

import { SukiProvider } from '@suki-sdk/react';

export function App() {
  return (
    <SukiProvider>
      {/* Your app */}
    </SukiProvider>
  );
}

import { SukiAuthManager } from '@suki-sdk/core';
import { initialize } from '@suki-sdk/js';

const authManager = new SukiAuthManager({
  partnerId: 'your-partner-id',
  partnerToken: 'your-partner-token',
  providerName: 'Jane Doe',
  providerOrgId: 'org-123',
  environment: 'production',
  loginOnInitialize: true,
});

const sdkClient = initialize({ authManager });

import SukiAmbientCore

SukiAmbientCoreManager.shared.environment = .stage

let partnerInfo: [String: AnyHashable] = [
    SukiAmbientConstant.kPartnerId: "your-partner-id",
    SukiAmbientConstant.kProviderInfo: [
        SukiAmbientConstant.kOrgId: "your-org-id",
        SukiAmbientConstant.kName: "Provider name",
        SukiAmbientConstant.kId: "provider-id",
        SukiAmbientConstant.kSpeciality: "FAMILY_MEDICINE",
    ],
]

try SukiAmbientCoreManager.shared.initialize(
    withPartnerInfo: partnerInfo,
    with: true,
    onCompletion: { _ in },
    withSessionDelegate: self,
    withTokenProvider: self
)

Choose your SDK workflow

Available SDKs

Pick the SDK for your use case and workflow and start building your integration.

Start building

Workflows OverviewLearn more about comparing SDKs and how to choose your integration path.Web SDK - Create SessionBuild your first ambient session, stream audio, and retrieve the note in minutes.Mobile SDK - Create SessionBuild your first ambient session, stream audio, and retrieve the note in minutes.Headless Web SDK - Create SessionBuild your first ambient session, stream audio, and retrieve the note in minutes.Dictation SDK - ConfigurationConfigure the Dictation SDK with your partner credentials and settings.Web SDK QuickstartBuild your first headed Web SDK flow in minutes.Headless Web SDK QuickstartBuild your first headless ambient flow in minutes.Partner OnboardingLearn more about partner onboarding to start using Suki SDKs.

Stay updated

Learn about the latest updates for the Web SDK, Mobile SDK, Headless Web SDK, and Dictation SDK.

Web SDK Changelog

Releases and migration notes for the headed Web SDK packages.

Mobile SDK Changelog

iOS SDK updates, deprecations, and behavior changes.

Headless Web SDK Changelog

Platform React package updates for ambient hooks and clients.

Dictation SDK Changelog

Dictation iframe and package updates for JavaScript and React tracks.