.NET
Dapr offers a variety of packages to help with the development of .NET applications. Using them you can create .NET clients, servers, and virtual actors with Dapr.
Prerequisites
- Dapr CLI installed
- Initialized Dapr environment
- .NET 8, .NET 9, or .NET 10 installed
Note
The Dapr .NET SDK supports .NET 8, .NET 9, and .NET 10. .NET 8 and .NET 9 will remain supported until the first Dapr release after their end of life in November 2026, after which we expect to support .NET 10 and .NET 11 instead.Installation
To get started with the Client .NET SDK, install the Dapr .NET SDK package:
dotnet add package Dapr.Client
Try it out
Put the Dapr .NET SDK to the test. Walk through the .NET quickstarts and tutorials to see Dapr in action:
| SDK samples | Description |
|---|---|
| Quickstarts | Experience Dapr’s API building blocks in just a few minutes using the .NET SDK. |
| SDK samples | Clone the SDK repo to try out some examples and get started. |
| Pub/sub tutorial | See how Dapr .NET SDK works alongside other Dapr SDKs to enable pub/sub applications. |
Available packages
| Package Name | Documentation Link | Description |
|---|---|---|
| Dapr.Client | Documentation | Create .NET clients that interact with a Dapr sidecar and other Dapr applications. |
| Dapr.AI | Documentation | Create and manage AI operations in .NET. |
| Dapr.AI.A2a | Dapr SDK for implementing agent-to-agent operations using the A2A framework. | |
| Dapr.AI.Microsoft.Extensions | Documentation | Easily interact with LLMs conversationally and using tooling via the Dapr Conversation building block. |
| Dapr.AspNetCore | Documentation | Write servers and services in .NET using the Dapr SDK. Includes support and utilities providing richer integration with ASP.NET Core. |
| Dapr.Actors | Documentation | Create virtual actors with state, reminders/timers, and methods. |
| Dapr.Actors.AspNetCore | Documentation | Create virtual actors with state, reminders/timers, and methods with rich integration with ASP.NET Core. |
| Dapr.Actors.Analyzers | Documentation | A collection of Roslyn source generators and analyzers for enabling better practices and preventing common errors when using Dapr Actors in .NET. |
| Dapr.Cryptography | Documentation | Encrypt and decrypt streaming state of any size using Dapr’s cryptography building block. |
| Dapr.Jobs | Documentation | Create and manage the scheduling and orchestration of jobs. |
| Dapr.Jobs.Analyzers | Documentation | A collection of Roslyn source generators and analyzers for enabling better practices and preventing common errors when using Dapr Jobs in .NET. |
| Dapr.DistributedLocks | Documentation | Create and manage distributed locks for managing exclusive resource access. |
| Dapr.Extensions.Configuration | Dapr secret store configuration provider implementation for Microsoft.Extensions.Configuration. | |
| Dapr.PluggableComponents | Used to implement pluggable components with Dapr using .NET. | |
| Dapr.PluggableComponents.AspNetCore | Implement pluggable components with Dapr using .NET with rich ASP.NET Core support. | |
| Dapr.PluggableComponents.Protos | Note: Developers needn’t install this package directly in their applications. | |
| Dapr.Messaging | Documentation | Build distributed applications using the Dapr Messaging SDK that utilize messaging components like streaming pub/sub subscriptions. |
| Dapr.Testcontainers | Documentation | Run Dapr integration tests using Testcontainers-based harnesses. |
| Dapr.Workflow | Documentation | Create and manage workflows that work with other Dapr APIs. |
| Dapr.Workflow.Versioning | Documentation | Add workflow versioning strategies for evolving long-running workflows. |
| Dapr.Workflow.Analyzers | Documentation | A collection of Roslyn source generators and analyzers for enabling better practices and preventing common errors when using Dapr Workflows in .NET |
More information
Learn more about local development options, best practices, or browse NuGet packages to add to your existing .NET applications.