Humanizer
+
+[](https://dev.azure.com/dotnet/Humanizer/_build?definitionId=14)
+[](https://www.nuget.org/packages/Humanizer)
+[](https://www.nuget.org/packages/Humanizer.Core)
+
+Humanizer turns numbers, dates, enums, quantities, and strings into natural language across more than 40 locales. Use it to surface human-friendly text in any .NET application with minimal ceremony.
+
+> Docs: see the [documentation folder](docs/index.md) for conceptual guides, API reference, and operational playbooks.
+
+## Install
+
+Install from NuGet with the package that matches your localization needs:
+
+```bash
+# All languages
+dotnet add package Humanizer
+
+# English only
+dotnet add package Humanizer.Core
+```
+
+Add satellite packages when you only need specific languages:
+
+| Scenario | Package | Example command |
+| --- | --- | --- |
+| French | `Humanizer.Core.fr` | `dotnet add package Humanizer.Core.fr` |
+| Spanish | `Humanizer.Core.es` | `dotnet add package Humanizer.Core.es` |
+| Multiple locales | Install each locale package alongside `Humanizer.Core` | `dotnet add package Humanizer.Core.de` |
+
+### Supported frameworks
+- .NET 10.0
+- .NET 9.0
+- .NET 8.0
+- .NET Framework 4.8
+- .NET Standard 2.0 (analyzer and MSBuild scenarios)
+
+> Restore requirements: the `Humanizer` metapackage needs the NuGet locale fix included in .NET SDK 9.0.200 and corresponding Visual Studio or MSBuild updates. Older toolsets must reference `Humanizer.Core` plus specific `Humanizer.Core.{{ site.description }}
-