OllamaSharp 4.0.0-preview.10
See the version list below for details.
dotnet add package OllamaSharp --version 4.0.0-preview.10
NuGet\Install-Package OllamaSharp -Version 4.0.0-preview.10
<PackageReference Include="OllamaSharp" Version="4.0.0-preview.10" />
<PackageVersion Include="OllamaSharp" Version="4.0.0-preview.10" />
<PackageReference Include="OllamaSharp" />
paket add OllamaSharp --version 4.0.0-preview.10
#r "nuget: OllamaSharp, 4.0.0-preview.10"
#:package OllamaSharp@4.0.0-preview.10
#addin nuget:?package=OllamaSharp&version=4.0.0-preview.10&prerelease
#tool nuget:?package=OllamaSharp&version=4.0.0-preview.10&prerelease
<p align="center"> <img alt="ollama" height="200px" src="https://github.com/awaescher/OllamaSharp/blob/main/Ollama.png"> </p>
OllamaSharp 🦙
OllamaSharp provides .NET bindings for the Ollama API, simplifying interactions with Ollama both locally and remotely.
✅ Supporting Microsoft.Extensions.AI and Microsoft Semantic Kernel
Features
- Ease of use: Interact with Ollama in just a few lines of code.
 - API endpoint coverage: Support for all the Ollama API endpoints, including chats, embeddings, listing models, pulling and creating new models, and more.
 - Real-time streaming: Stream responses directly to your application.
 - Progress reporting: Get real-time progress feedback on tasks like model pulling.
 - Support for vision models and tools (function calling).
 
Usage
OllamaSharp wraps each Ollama API endpoint in awaitable methods that fully support response streaming.
The following list shows a few simple code examples.
ℹ Try our full featured demo application that's included in this repository
Initializing
// set up the client
var uri = new Uri("http://localhost:11434");
var ollama = new OllamaApiClient(uri);
// select a model which should be used for further operations
ollama.SelectedModel = "llama3.1:8b";
Listing all models that are available locally
var models = await ollama.ListLocalModelsAsync();
Pulling a model and reporting progress
await foreach (var status in ollama.PullModelAsync("llama3.1:405b"))
    Console.WriteLine($"{status.Percent}% {status.Status}");
Generating a completion directly into the console
await foreach (var stream in ollama.GenerateAsync("How are you today?"))
    Console.Write(stream.Response);
Building interactive chats
var chat = new Chat(ollama);
while (true)
{
    var message = Console.ReadLine();
    await foreach (var answerToken in chat.SendAsync(message))
        Console.Write(answerToken);
}
// messages including their roles and tool calls will automatically be tracked within the chat object
// and are accessible via the Messages property
Credits
The icon and name were reused from the amazing Ollama project.
I would like to thank all the contributors who take the time to improve OllamaSharp. First and foremost mili-tan, who always keeps OllamaSharp in sync with the Ollama API. ❤
| Product | Versions Compatible and additional computed target framework versions. | 
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. | 
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. | 
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. | 
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. | 
| MonoAndroid | monoandroid was computed. | 
| MonoMac | monomac was computed. | 
| MonoTouch | monotouch was computed. | 
| Tizen | tizen40 was computed. tizen60 was computed. | 
| Xamarin.iOS | xamarinios was computed. | 
| Xamarin.Mac | xamarinmac was computed. | 
| Xamarin.TVOS | xamarintvos was computed. | 
| Xamarin.WatchOS | xamarinwatchos was computed. | 
- 
                                                    
.NETStandard 2.0
- Microsoft.Bcl.AsyncInterfaces (>= 9.0.0-rc.2.24473.5)
 - Microsoft.Extensions.AI.Abstractions (>= 9.0.0-preview.9.24507.7)
 
 
NuGet packages (25)
Showing the top 5 NuGet packages that depend on OllamaSharp:
| Package | Downloads | 
|---|---|
| 
                                                        
                                                            Microsoft.SemanticKernel.Connectors.Ollama
                                                        
                                                            
                                                         Semantic Kernel connector for Ollama. Contains services for text generation, chat completion and text embeddings.  | 
                                                    |
| 
                                                        
                                                            Microsoft.KernelMemory.AI.Ollama
                                                        
                                                            
                                                         Provide access to Ollama LLM models in Kernel Memory to generate embeddings and text  | 
                                                    |
| 
                                                        
                                                            CommunityToolkit.Aspire.OllamaSharp
                                                        
                                                            
                                                         A .NET Aspire client integration for the OllamaSharp library.  | 
                                                    |
| 
                                                        
                                                            CommunityToolkit.Aspire.Hosting.Ollama
                                                        
                                                            
                                                         An Aspire integration leveraging the Ollama container with support for downloading a model on startup.  | 
                                                    |
| 
                                                        
                                                            EnergyAssembly
                                                        
                                                         Package Description  | 
                                                    
GitHub repositories (16)
Showing the top 16 popular GitHub repositories that depend on OllamaSharp:
| Repository | Stars | 
|---|---|
| 
                                                        
                                                            microsoft/semantic-kernel
                                                        
                                                         
                                                            Integrate cutting-edge LLM technology quickly and easily into your apps
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            testcontainers/testcontainers-dotnet
                                                        
                                                         
                                                            A library to support tests with throwaway instances of Docker containers for all compatible .NET Standard versions.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            dotnet/extensions
                                                        
                                                         
                                                            This repository contains a suite of libraries that provide facilities commonly needed when creating production-ready applications.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            microsoft/kernel-memory
                                                        
                                                         
                                                            RAG architecture: index and query any data using LLM and natural language, track sources, show citations, asynchronous memory patterns.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            microsoft/Generative-AI-for-beginners-dotnet
                                                        
                                                         
                                                            Five lessons, learn how to really apply AI to your .NET Applications
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            microsoft/ai-dev-gallery
                                                        
                                                         
                                                            An open-source project for Windows developers to learn how to add AI with local models and APIs to Windows apps.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            getcellm/cellm
                                                        
                                                         
                                                            Use LLMs in Excel formulas
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            mixcore/mix.core
                                                        
                                                         
                                                            🚀 A future-proof enterprise web CMS supporting both headless and decoupled approaches. Build any type of app with customizable APIs on ASP.NET Core/.NET Core. Completely open-source and designed for flexibility.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            dotnet/ai-samples
                                                        
                                                         | 
                                                    |
| 
                                                        
                                                            CommunityToolkit/Aspire
                                                        
                                                         
                                                            A community project with additional components and extensions for .NET Aspire
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            anobaka/Bakabase
                                                        
                                                         
                                                            A local media manager for all types of files. 二次元老司机专用的本地媒体文件管理器,支持管理和处理音视频、本子、图集、小说、哔哩哔哩视频、游戏甚至mod等各类资源
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            PowerShell/AIShell
                                                        
                                                         
                                                            An interactive shell to work with AI-powered assistance providers
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            axzxs2001/Asp.NetCoreExperiment
                                                        
                                                         
                                                            原来所有项目都移动到**OleVersion**目录下进行保留。新的案例装以.net 5.0为主,一部分对以前案例进行升级,一部分将以前的工作经验总结出来,以供大家参考!
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            afrise/MCPSharp
                                                        
                                                         
                                                            MCPSharp is a .NET library that helps you build Model Context Protocol (MCP) servers and clients - the standardized API protocol used by AI assistants and models.
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            lindexi/lindexi_gd
                                                        
                                                         
                                                            博客用到的代码
                                                         
                                                     | 
                                                    |
| 
                                                        
                                                            petabridge/memorizer-v1
                                                        
                                                         
                                                            Vector-search powered agent memory MCP server
                                                         
                                                     | 
                                                    
| Version | Downloads | Last Updated | 
|---|---|---|
| 5.4.8 | 11,792 | 10/17/2025 | 
| 5.4.7 | 22,306 | 9/25/2025 | 
| 5.4.6 | 13,733 | 9/22/2025 | 
| 5.4.5 | 5,310 | 9/19/2025 | 
| 5.4.4 | 4,491 | 9/15/2025 | 
| 5.4.3 | 2,308 | 9/15/2025 | 
| 5.4.2 | 1,224 | 9/15/2025 | 
| 5.4.1 | 6,578 | 9/11/2025 | 
| 5.3.12 | 2,359 | 9/10/2025 | 
| 5.3.11 | 1,034 | 9/10/2025 | 
| 5.3.10 | 1,035 | 9/10/2025 | 
| 5.3.9 | 1,025 | 9/10/2025 | 
| 5.3.8 | 1,039 | 9/10/2025 | 
| 5.3.7 | 1,051 | 9/10/2025 | 
| 5.3.6 | 19,311 | 8/20/2025 | 
| 5.3.5 | 53,437 | 8/18/2025 | 
| 5.3.4 | 8,640 | 8/2/2025 | 
| 5.3.3 | 7,098 | 7/22/2025 | 
| 5.3.2 | 1,148 | 7/22/2025 | 
| 5.3.1 | 1,905 | 7/19/2025 | 
| 5.2.10 | 4,685 | 7/14/2025 | 
| 5.2.9 | 4,393 | 7/13/2025 | 
| 5.2.8 | 2,955 | 7/10/2025 | 
| 5.2.7 | 3,587 | 7/7/2025 | 
| 5.2.6 | 1,457 | 7/4/2025 | 
| 5.2.5 | 750 | 7/4/2025 | 
| 5.2.4 | 744 | 7/4/2025 | 
| 5.2.3 | 41,489 | 6/23/2025 | 
| 5.2.2 | 24,658 | 5/30/2025 | 
| 5.2.1 | 787 | 5/30/2025 | 
| 5.1.20 | 2,115 | 5/30/2025 | 
| 5.1.19 | 4,018 | 5/23/2025 | 
| 5.1.18 | 18,026 | 5/19/2025 | 
| 5.1.17 | 1,293 | 5/16/2025 | 
| 5.1.16 | 1,455 | 5/13/2025 | 
| 5.1.15 | 528 | 5/13/2025 | 
| 5.1.14 | 42,044 | 5/6/2025 | 
| 5.1.13 | 12,863 | 4/10/2025 | 
| 5.1.12 | 179,433 | 4/10/2025 | 
| 5.1.11 | 4,637 | 4/9/2025 | 
| 5.1.10 | 2,189 | 4/7/2025 | 
| 5.1.9 | 4,533 | 3/27/2025 | 
| 5.1.8 | 359 | 3/27/2025 | 
| 5.1.7 | 90,819 | 3/14/2025 | 
| 5.1.6 | 351 | 3/14/2025 | 
| 5.1.5 | 1,180 | 3/13/2025 | 
| 5.1.4 | 3,001 | 3/5/2025 | 
| 5.1.3 | 637 | 3/4/2025 | 
| 5.1.2 | 25,547 | 2/24/2025 | 
| 5.1.1 | 1,328 | 2/21/2025 | 
| 5.1.0 | 329 | 2/21/2025 | 
| 5.0.7 | 37,758 | 2/17/2025 | 
| 5.0.6 | 34,478 | 2/3/2025 | 
| 5.0.5 | 1,461 | 1/31/2025 | 
| 5.0.4 | 4,194 | 1/27/2025 | 
| 5.0.3 | 3,560 | 1/22/2025 | 
| 5.0.2 | 9,014 | 1/15/2025 | 
| 5.0.1 | 646 | 1/15/2025 | 
| 4.0.22 | 10,755 | 1/10/2025 | 
| 4.0.21 | 272 | 1/9/2025 | 
| 4.0.20 | 530 | 1/8/2025 | 
| 4.0.19 | 211 | 1/8/2025 | 
| 4.0.18 | 593 | 1/8/2025 | 
| 4.0.17 | 39,674 | 1/3/2025 | 
| 4.0.16 | 250 | 1/3/2025 | 
| 4.0.15 | 256 | 1/3/2025 | 
| 4.0.14 | 264 | 1/3/2025 | 
| 4.0.13 | 248 | 1/3/2025 | 
| 4.0.12 | 242 | 1/3/2025 | 
| 4.0.11 | 37,251 | 12/9/2024 | 
| 4.0.10 | 244 | 12/9/2024 | 
| 4.0.9 | 2,001 | 12/2/2024 | 
| 4.0.8 | 36,255 | 11/22/2024 | 
| 4.0.7 | 4,281 | 11/13/2024 | 
| 4.0.6 | 16,614 | 11/7/2024 | 
| 4.0.5 | 1,539 | 11/5/2024 | 
| 4.0.4 | 747 | 11/4/2024 | 
| 4.0.3 | 35,294 | 10/30/2024 | 
| 4.0.2 | 425 | 10/29/2024 | 
| 4.0.1 | 2,405 | 10/26/2024 | 
| 4.0.0-preview.10 | 153 | 10/23/2024 | 
| 4.0.0-preview.9 | 118 | 10/21/2024 | 
| 4.0.0-preview.8 | 140 | 10/17/2024 | 
| 3.0.15 | 5,964 | 10/21/2024 | 
| 3.0.14 | 11,668 | 10/16/2024 | 
| 3.0.13 | 192 | 10/16/2024 | 
| 3.0.12 | 22,449 | 10/14/2024 | 
| 3.0.11 | 1,593 | 10/9/2024 | 
| 3.0.10 | 30,078 | 10/4/2024 | 
| 3.0.9 | 226 | 10/4/2024 | 
| 3.0.8 | 19,059 | 9/26/2024 | 
| 3.0.7 | 35,424 | 9/12/2024 | 
| 3.0.6 | 1,313 | 9/11/2024 | 
| 3.0.5 | 888 | 9/11/2024 | 
| 3.0.4 | 26,916 | 9/6/2024 | 
| 3.0.3 | 212 | 9/6/2024 | 
| 3.0.2 | 692 | 9/5/2024 | 
| 3.0.1 | 24,109 | 9/2/2024 | 
| 3.0.0 | 2,291 | 8/26/2024 | 
| 2.1.3 | 2,817 | 8/23/2024 | 
| 2.1.2 | 2,846 | 8/19/2024 | 
| 2.1.1 | 4,583 | 8/5/2024 | 
| 2.0.15 | 413 | 8/5/2024 | 
| 2.0.14 | 183 | 8/3/2024 | 
| 2.0.13 | 2,119 | 7/29/2024 | 
| 2.0.12 | 219 | 7/28/2024 | 
| 2.0.11 | 295 | 7/28/2024 | 
| 2.0.10 | 5,239 | 7/12/2024 | 
| 2.0.9 | 188 | 7/12/2024 | 
| 2.0.8 | 225 | 7/12/2024 | 
| 2.0.7 | 1,955 | 7/10/2024 | 
| 2.0.6 | 3,204 | 6/25/2024 | 
| 2.0.5 | 215 | 6/25/2024 | 
| 2.0.4 | 669 | 6/24/2024 | 
| 2.0.3 | 200 | 6/24/2024 | 
| 2.0.2 | 254 | 6/24/2024 | 
| 2.0.1 | 4,182 | 6/5/2024 | 
| 1.1.13 | 746 | 6/5/2024 | 
| 1.1.12 | 756 | 6/4/2024 | 
| 1.1.11 | 390 | 6/2/2024 | 
| 1.1.10 | 1,397 | 5/31/2024 | 
| 1.1.9 | 7,380 | 5/15/2024 | 
| 1.1.8 | 1,447 | 5/10/2024 | 
| 1.1.7 | 224 | 5/10/2024 | 
| 1.1.5 | 222 | 5/10/2024 | 
| 1.1.4 | 352 | 5/10/2024 | 
| 1.1.3 | 219 | 5/10/2024 | 
| 1.1.2 | 212 | 5/10/2024 | 
| 1.1.1 | 4,213 | 3/27/2024 | 
| 1.1.0 | 2,388 | 1/8/2024 | 
| 1.0.4 | 388 | 12/27/2023 | 
| 1.0.3 | 460 | 11/30/2023 | 
| 1.0.2 | 471 | 11/5/2023 | 
| 1.0.1 | 314 | 10/16/2023 | 
| 1.0.0 | 2,491 | 10/16/2023 |