Orleans.FSharp 4.0.2

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Orleans.FSharp --version 4.0.2
                    


                    

                
NuGet\Install-Package Orleans.FSharp -Version 4.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Orleans.FSharp" Version="4.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Orleans.FSharp" Version="4.0.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Orleans.FSharp" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Orleans.FSharp --version 4.0.2
                    


                    

                
#r "nuget: Orleans.FSharp, 4.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Orleans.FSharp@4.0.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Orleans.FSharp&version=4.0.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Orleans.FSharp&version=4.0.2
                    


                            Install as a Cake Tool

Orleans.FSharp

Idiomatic F# computation expressions and helpers for Microsoft Orleans grain development.

Deprecated authoring model. The grain {} CE and the universal FSharpGrain.* message-passing surface shown below -- builder, GrainDefinition/GrainContext, handles, IFSharpGrain*, ref/send/post/ask, Timers, Reminder -- now carry [<Obsolete>] (warning, not error). They keep compiling and running; new code should use the functional grain runtime (grainContract / grainFor / FunctionalGrain.ref / AddFunctionalGrain) described under Functional grain runtime below. Migration guide: docs/functional-grains.md.

What it does

Orleans.FSharp replaces verbose C#-style grain implementations with a declarative grain {} computation expression. Define state, message handlers, persistence, timers, reminders, and streaming in a single expression. Concurrency is controlled per message type with interleaveMessage typeof<'Msg>, and FSharpGrain.post gives true fire-and-forget ([OneWay]) calls.

Modules included

GrainState | GrainRef | GrainBatch | Streaming | BroadcastChannel | Logging | Reminders | Timers | Observers | Filters | RequestCtx | Transactions | Versioning | GrainResilience | Shutdown | StateMigration | Serialization | FSharpSerialization | Scripting | Kubernetes | GrainDirectory | Immutable | StreamProviders

Quick example

open Orleans.FSharp

type CounterMsg = Increment | GetCount

let counterGrain = grain {
    defaultState 0
    handle (fun state msg -> task {
        match msg with
        | Increment  -> return state + 1, box ()
        | GetCount   -> return state,     box state
    })
    persist "Default"
}
Package Purpose
Orleans.FSharp.Runtime Silo and client hosting via siloConfig {} CE
Orleans.FSharp.CodeGen C# bridge for Orleans Roslyn source generators
Orleans.FSharp.Testing Test harness, mocks, and FsCheck integration
Orleans.FSharp.EventSourcing Event-sourced grains via eventSourcedGrain {} CE
Orleans.FSharp.Analyzers F# analyzer detecting async {} usage

Functional grain runtime

A second, independent authoring model lives alongside the grain {} CE: user-authored API records (grainContract / grainFor / FunctionalGrain.ref) instead of a CodeGen-generated C# interface. See Functional Grain Runtime for key-codec identity rules, operation rename and contract versioning, delivery semantics, immutable-state guidance, and the reminder rename/removal migration.

Documentation

Full docs and examples: https://github.com/Neftedollar/orleans-fsharp

License

MIT

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Orleans.FSharp:

Package Downloads
Orleans.FSharp.Runtime

Silo and client hosting for functional Orleans.FSharp actors — registration, serialization, health checks, Dashboard, TLS, and production configuration.
Orleans.FSharp.Testing

Test utilities for Orleans.FSharp grains — TestHarness, GrainMock, GrainArbitrary (TypeShape-based FsCheck), FsCheckHelpers, and LogCapture.
Orleans.FSharp.EventSourcing

Declarative event sourcing for Orleans grains in F# — eventSourcedGrain {} CE with apply/handle and a JournaledGrain bridge.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
5.0.1 127 9/7/2026
5.0.0 116 9/7/2026
4.1.0 154 8/21/2026
4.0.2 150 8/20/2026
4.0.1 130 8/20/2026
4.0.0 137 8/19/2026
3.0.2 133 8/8/2026
3.0.1 183 6/29/2026
3.0.0 172 6/29/2026
2.0.0-alpha.1 105 4/28/2026
1.0.0 338 4/3/2026

See https://github.com/Neftedollar/orleans-fsharp/blob/main/CHANGELOG.md