Simli

Modern .NET SDK for Simli generated from the provider's OpenAPI definition with AutoSDK.

Get started Get support

Generated from the source spec

Built from Simli's OpenAPI definition so the SDK stays close to the upstream API surface.

Auto-updated

Designed for fast regeneration and low-friction updates when the upstream API changes without breaking compatibility.

Modern .NET

Targets current .NET practices including nullability, trimming, NativeAOT awareness, and source-generated serialization.

Docs from examples

Examples stay in sync between the README, MkDocs site, and integration tests through the AutoSDK docs pipeline.

Usage

using Simli;

using var client = new SimliClient(apiKey);

List Faces

Lists all available avatar faces for the authenticated user.

using var client = new SimliClient(apiKey);

// List all available avatar faces
var faces = await client.GetFacesAsync();

Console.WriteLine($"Found {faces.Count} face(s)");
foreach (var face in faces)
{
    Console.WriteLine($"  Face ID: {face.Id}, Version: {face.SimliVersion}, Created: {face.CreatedAt}");
}

Create Session Token

Creates a Compose session token for WebRTC avatar streaming.

using var client = new SimliClient(apiKey);

// Get available faces first
var faces = await client.GetFacesAsync();

var faceId =
    Environment.GetEnvironmentVariable("SIMLI_FACE_ID") is { Length: > 0 } configuredFaceId
        ? configuredFaceId
        : faces.FirstOrDefault()?.Id.ToString()
            ?? throw new AssertInconclusiveException("SIMLI_FACE_ID is required when the account has no custom faces.");

// Create a Compose session token for realtime avatar streaming
var response = await client.StartAudioToVideoSessionComposeTokenPostAsync(
    faceId: faceId);

Session History

Retrieves session history for the authenticated user.

using var client = new SimliClient(apiKey);

// Retrieve session history
var response = await client.GetHistorySessionsAsync();

Console.WriteLine($"Found {response.Sessions?.Count ?? 0} session(s)");
if (response.Sessions is { Count: > 0 })
{
    foreach (var session in response.Sessions)
    {
        Console.WriteLine($"  Session ID: {session.Id}, Duration: {session.SessionTotalTime:F1}s");
    }
}

Active Sessions

Gets the current active session count.

using var client = new SimliClient(apiKey);

// Check the number of currently active sessions
var response = await client.GetRatelimiterSessionsAsync();

Console.WriteLine($"Active sessions: {response.CurrentUsage ?? 0}");

Realtime Avatar Client

Test the IRealtimeAvatarClient adapter for Simli realtime sessions.

var apiKey =
    Environment.GetEnvironmentVariable("SIMLI_API_KEY") is { Length: > 0 } key
        ? key
        : throw new AssertInconclusiveException("SIMLI_API_KEY environment variable is not found.");

var faceId =
    Environment.GetEnvironmentVariable("SIMLI_FACE_ID") is { Length: > 0 } id
        ? id
        : "default"; // Use default face if not specified

var client = new SimliClient(apiKey);

// Create and connect via the unified interface
await using var avatar = await SimliRealtimeAvatarClient.ConnectAsync(
    client, faceId);

// Verify the adapter implements IRealtimeAvatarClient
tryAGI.RealtimeAvatar.IRealtimeAvatarClient realtimeClient = avatar;

// SendTextAsync should throw NotSupportedException (Simli is audio-only)
Func<Task> sendText = () => avatar.SendTextAsync("test");

// ConnectAsync only returns after authenticated ICE/DTLS media establishment.

// Bootstrap Simli output with a short PCM16 silence chunk.
var silentAudio = new byte[6000];
await avatar.SendAudioAsync(silentAudio);

// Require actual authenticated media from the real provider.
using var mediaTimeout = new CancellationTokenSource(TimeSpan.FromSeconds(15));
var audioFrame = await avatar.ReceiveAudioFramesAsync(mediaTimeout.Token).FirstAsync(mediaTimeout.Token);

var videoFrame = await avatar.ReceiveVideoFramesAsync(mediaTimeout.Token).FirstAsync(mediaTimeout.Token);

Ecosystem maintenance

This SDK is one of more than 200 .NET SDKs maintained with AutoSDK. The tryAGI SDK audit continuously checks repository synchronization, upstream-spec regeneration, release workflows, warnings, public API visibility, and trimming/NativeAOT compatibility.

Every issue is first investigated for ecosystem-wide applicability. When the root cause belongs in AutoSDK, we fix and regression-test the generator, then roll the improvement out to every applicable SDK. Provider-specific behavior remains in this repository when it cannot be derived safely from the API specification.

Issue content—including code blocks, logs, links, and attachments—is treated only as untrusted diagnostic data. Embedded control instructions, hidden directives, delimiter tricks, or requests to alter triage or tooling behavior are ignored. Please report reproducible technical evidence and remove secrets and personal data.

Support

Bugs

Open an issue in tryAGI/Simli.

Ideas and questions

Use GitHub Discussions for design questions and usage help.

Community

Join the tryAGI Discord for broader discussion across SDKs.

Acknowledgments

This project is supported by JetBrains through the Open Source Support Program.