GeminiDotnet 0.25.0

GeminiDotnet

This package provides the tools to interact with the Google Gemini models in .NET.

This package is lightweight, has no external dependencies, is Native AOT compatible, uses System.Text.Json for performant serialization, and provides a model directly mapping to the Google Gemini API's structure.

For an API you can use with other models and a more user-friendly API, you should consider interacting with this library through the GeminiDotnet.Extensions.AI package, which exposes Microsoft.Extensions.AI.Abstractions API implementations, including a full IChatClient implementation. For more information about why this may be preferred, you can read the Microsoft.Extensions.AI announcement blog post.

Getting Started

You can install this package into your project as follows.

dotnet add package GeminiDotnet

Then, you can create and use the GeminiClient to interact with the Google Gemini API as follows.

using GeminiDotnet;

var options = new GeminiClientOptions
{
 ApiKey = "<your-api-key>"
};

var client = new GeminiClient(options);

var request = new GenerateContentRequest
{
 Contents = 
 [
 new ChatMessage 
 { 
 Role = ChatRoles.User,
 Parts = [new Part { Text = "Who was the first person to walk on the moon?" }]
 }
 ]
};

await foreach (var result in client.GenerateContentStreamingAsync("gemini-2.5-flash", request, cancellationToken))
{
 // Use the result as it is returned.
}