maui-essentials-ai

MAUI Essentials AI

Use this skill when a MAUI app should use on-device AI through Microsoft.Maui.Essentials.AI and Microsoft.Extensions.AI abstractions.

Response Checklist

• Mention the package and primary types explicitly: Microsoft.Maui.Essentials.AI, AppleIntelligenceChatClient, NLEmbeddingGenerator.
• Keep platform support explicit (Apple chat support is iOS/macOS/Mac Catalyst 26+; embeddings have broader Apple OS coverage).
• For app tools, show UseFunctionInvocation and route source-generated tool definitions to maui-ai-tool-bindings when appropriate.

Platform Support

Chat support:

Platform	Status
iOS 26+	Apple Intelligence / Foundation Models
Mac Catalyst 26+	Apple Intelligence
macOS 26+	Apple Intelligence
Android	Coming soon
Windows	Coming soon

Embedding support:

Platform	Status
iOS 13+	NaturalLanguage embeddings
Mac Catalyst 13.1+	NaturalLanguage embeddings
macOS 10.15+	NaturalLanguage embeddings
Android	Not supported
Windows	Not supported

Version numbers for Apple Intelligence support reflect currently announced OS versions; verify final released platform versions before shipping.

Design fallback behavior for unsupported platforms. Do not silently route private data to a cloud model unless the user explicitly wants a cloud fallback.

Install and Register

dotnet add package Microsoft.Maui.Essentials.AI --prerelease

using Microsoft.Extensions.AI;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Maui.Essentials.AI;

#if IOS || MACCATALYST || MACOS
builder.Services.AddSingleton<NLEmbeddingGenerator>();
builder.Services.AddSingleton<IEmbeddingGenerator<string, Embedding<float>>>(sp =>
    sp.GetRequiredService<NLEmbeddingGenerator>());

if (OperatingSystem.IsIOSVersionAtLeast(26) ||
    OperatingSystem.IsMacCatalystVersionAtLeast(26) ||
    OperatingSystem.IsMacOSVersionAtLeast(26))
{
    builder.Services.AddSingleton<IChatClient>(new AppleIntelligenceChatClient());
}
else
{
    // Leave IChatClient unregistered and check availability before use,
    // or register an app-specific unavailable implementation.
}
#endif