November 13th, 2024

Introducing the .NET Aspire Community Toolkit

Aaron Powell
Principal Cloud Advocate

We’re excited to announce the official release of the .NET Aspire Community Toolkit which you can get on NuGet and supports .NET Aspire 9! The Community Toolkit contains a collection of integrations and extensions that help you build with .NET Aspire.

🤔 What is the .NET Aspire Community Toolkit?

.NET Aspire has grown massively since it was first released, tackling more and more scenarios, which in turn brings the need for more integrations to support these kinds of applications. While many of these integrations are built by the .NET Aspire team, they can’t cover everything. That’s where the .NET Aspire Community Toolkit comes in.

The team behind the Community Toolkit wanted to create a place where third parties could contribute their own integrations and extensions to the .NET Aspire ecosystem. This way, the community can help shape the future of .NET Aspire and make it even more powerful, freeing the focus of the .NET Aspire team to work on the core framework. We’ve put a lot of effort into making the Community Toolkit easy to use and contribute to, and easy to maintain through examples, documentation, testing, and more.

🚀 What’s in the .NET Aspire Community Toolkit?

Today, the Community Toolkit contains nearly a dozen integrations across both hosting and client, with more being added all the time. Here are some of the highlights:

You can find all the integrations available in the Community Toolkit on the official documentation, or by checking out the GitHub repository.

🎉 Get started with the .NET Aspire Community Toolkit

To get started with the .NET Aspire Community Toolkit, you can install it from NuGet via the Visual Studio tooling, VS Code tooling or the .NET CLI. Let’s take the the Ollama hosting integration as an example. Navigate to your app host project and install the package:

Or via the command line:

dotnet add package CommunityToolkit.Aspire.Hosting.Ollama

Then, you can configure the Ollama hosting integration in your Program.cs file:

var ollama =
        builder.AddOllama("ollama")
               .WithDataVolume()
               .WithOpenWebUI();

var llama = ollama.AddModel("llama3.2");

builder.AddProject<Projects.MyApi>("api")
       .WithReference(llama);

Now you can provide the ollama resource to any of the other services in the app host and consume it with a client library, like OllamaSharp (which we have an integration for too!).

🤝 Contribute to the .NET Aspire Community Toolkit

The .NET Aspire Community Toolkit couldn’t exist without the community. Big thanks to @justinyoo, @tommasodotNET, @FBoucher, @Alirexaa and @Mrxx99 for their contributions to the project so far!

But of course, we welcome contributions from the community. If you have an integration or extension that you think would be useful to others, we’d love to see it! You can find out more about contributing on the GitHub repository.

So come and join us on GitHub, give us a star ⭐, and let’s create some awesome integrations together!

Author

Aaron Powell
Principal Cloud Advocate

Aaron is a Developer Advocate at Microsoft. Having spent 15 years doing web development he’s seen it all, from browser wars, the rise of AJAX and the fall of 20 JavaScript frameworks (and that was just yesterday!). Always tinkering with something new he explores crazy ideas like writing your own implementation of numbers in .NET, creating IoC in JavaScript or implementing tic-tac-toe using git commits.

0 comments