OllamaClient

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #go #deep-learning #docker #nodejs #java #cli #kubernetes #awesome-list #vue #openai

(★ 10)

.NET client library for Ollama - your gateway to seamless integration with the powerful Ollama APIs. This library provides developers with a straightforward way to interact with Ollama APIs, enabling rapid development of robust applications in C#.

OllamaClient Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OllamaClient

.NET client library for [Ollama](https://github.com/ollama/ollama) — run large language models locally and integrate them into your C# applications with minimal boilerplate.

[![build and test](https://github.com/Dev-Art-Solutions/OllamaClient/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/Dev-Art-Solutions/OllamaClient/actions/workflows/build-and-test.yml)
[![NuGet](https://img.shields.io/nuget/v/OllamaClient.svg)](https://www.nuget.org/packages/OllamaClient/)
[![Downloads](https://img.shields.io/nuget/dt/OllamaClient.svg)](https://www.nuget.org/packages/OllamaClient/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/Dev-Art-Solutions/OllamaClient/main/LICENSE)

## Quick Start

**Install:**

```bash
dotnet add package OllamaClient
```

**Use:**

```csharp
using Microsoft.Extensions.DependencyInjection;
using OllamaClient;
using OllamaClient.Extensions;

var services = new ServiceCollection()
    .AddOllamaClient()          // defaults to http://localhost:11434/
    .BuildServiceProvider();

var client = services.GetRequiredService<IOllamaHttpClient>();

// List available models
var models = await client.GetModels(CancellationToken.None);

// Streaming chat
await foreach (var chunk in client.SendChat(new ChatStreamRequest
{
    Model = models.Models[0].Name,
    Messages = [new Message { Role = "user", Content = "Hello!" }]
}, CancellationToken.None))
{
    Console.Write(chunk.Message?.Content);
}
```

## Features

| Endpoint | Method | Streaming |
|----------|--------|-----------|
| `GET /api/tags` | `GetModels()` | — |
| `POST /api/generate` | `Generate()` | `Generate(GenerateStreamRequest)` |
| `POST /api/chat` | `SendChat()` | `SendChat(ChatStreamRequest)` |
| `POST /api/create` | `Create()` | `Create(CreateModelStreamRequest)` |
| `POST /api/copy` | `Copy()` | — |
| `POST /api/delete` | `Delete()` | — |
| `POST /api/show` | `Show()` | — |
| `POST /api/pull` | `Pull()` | `Pull(PullStreamRequest)` |
| `POST /api/push` | `Push()` | `Push(PushStreamRequest)` |
| `POST /api/embeddings` | `GetEmbeddings()` | — |

**Stateful multi-turn chat** is available via `IStatefulConversationOllamaService`, which manages message history automatically across turns.

## Configuration

### Dependency injection (default endpoint)

```csharp
services.AddOllamaClient();
// connects to http://localhost:11434/
```

### Custom base URL

```csharp
services.AddOllamaClient(cfg =>
{
    cfg.OllamaEndpoint = "http://my-ollama-host:11434/";
});
```

### Timeout

Configure the underlying `HttpClient` via the standard `IHttpClientBuilder`:

```csharp
services.AddOllamaClient();
services.AddHttpClient<OllamaHttpClient>()
        .ConfigureHttpClient(c => c.Timeout = TimeSpan.FromMinutes(5));
```

## Examples

See [`src/OllamaClient.QuickStart/`](src/OllamaClient.QuickStart/) for a runnable console app demonstrating pull, list, and streaming chat.

## Compatibility

| OllamaClient | .NET | Minimum Ollama |
|---|---|---|
| 1.1.x | net9.0, net10.0 | 0.1.x |
| 1.0.x | net8.0 | 0.1.x |

## Contributing

Pull requests are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening an issue or PR.

## License

MIT — see [LICENSE](LICENSE).

OllamaClient

OllamaClient Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

OllamaClient

OllamaClient Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README