https://github.com/azure/microsoft-agent-framework-foundry-starter-pack-net
This provides a starter template to build an agentic AI app using Microsoft Agent Framework and Microsoft Foundry with Aspire
https://github.com/azure/microsoft-agent-framework-foundry-starter-pack-net
aspire azure mcp microsoft-agent-framework microsoft-foundry starter-pack
Last synced: about 2 months ago
JSON representation
This provides a starter template to build an agentic AI app using Microsoft Agent Framework and Microsoft Foundry with Aspire
- Host: GitHub
- URL: https://github.com/azure/microsoft-agent-framework-foundry-starter-pack-net
- Owner: Azure
- License: mit
- Created: 2026-03-16T04:40:19.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-06T01:31:37.000Z (2 months ago)
- Last Synced: 2026-04-06T03:23:18.065Z (2 months ago)
- Topics: aspire, azure, mcp, microsoft-agent-framework, microsoft-foundry, starter-pack
- Language: JavaScript
- Homepage:
- Size: 70.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Microsoft Agent Framework and Foundry Starter Pack in .NET
This is a starter template to build a .NET-based agentic AI app using [Microsoft Agent Framework](https://aka.ms/agent-framework) and [Microsoft Foundry](https://aka.ms/microsoft-foundry) with [Aspire](https://aspire.dev).
## What is this starter pack for?
Building AI agents is getting easier. Deploying them as part of a real application, with multiple services, persistent state, and production infrastructure, is where things get complicated. But where should we start building architecture to deploy them onto the cloud in a cloud-native way?
This starter pack is where you should start from. It's an opinionated way to build an AI agent system using [Microsoft Agent Framework](https://aka.ms/agent-framework) and [Microsoft Foundry](https://aka.ms/microsoft-foundry) with [Aspire](https://aspire.dev). If you're unsure where to start, this starter pack will guide you walk through.
## Features
This stater template provides the following features:
- [Blazor](https://blazor.net) frontend for chat UI
- [ASP.NET](https://asp.net) backend with [Microsoft Agent Framework](https://aka.ms/agent-framework)
- [Microsoft Foundry Agent Service](https://aka.ms/microsoft-foundry/agent-service) for agent hosting
- [To-do list management MCP server](https://aka.ms/mcp/dotnet/samples/todolist) for tooling support to agent
- [Aspire](https://aspire.dev) for cloud-native app orchestration
## Prerequisites
- [Azure subscription (free)](http://azure.microsoft.com/free)
- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) or higher
- [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/) or [VS Code](https://code.visualstudio.com/download) + [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
- [Docker Desktop](https://docs.docker.com/desktop/) or equivalent
- [Azure Developer CLI](https://learn.microsoft.com/azure/developer/azure-developer-cli/install-azd)
- [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli)
- [Aspire CLI](https://aspire.dev/get-started/install-cli/)
## Quickstart
This starter pack has a two-step deployment process, which mimicks the real-world scenario. Agents and apps are usually deployed separately.
1. Deploy agent to Microsoft Foundry.
1. Deploy apps via Aspire.
### Get repository root
1. Get the repository root.
```bash
# bash/zsh
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
```
```powershell
# PowerShell
$REPOSITORY_ROOT = git rev-parse --show-toplevel
```
### Login to Azure
1. Login to Azure using `azd`.
```bash
azd auth login
```
1. Login to Azure using `az`.
```bash
az login
```
### Deploy Microsoft Foundry Agent Service
1. Navigate to the `resources-foundry` directory.
```bash
cd $REPOSITORY_ROOT/resources-foundry
```
1. Deploy a prompt agent to Microsoft Foundry.
```bash
azd up
```
While provisioning, you might be asked to enter environment name, Azure subscription and location.
> **NOTE**: You may have to set the environment variable, `AZURE_TENANT_ID`.
>
> ```bash
> # bash/zsh
> AZURE_TENANT_ID=$(az account show --query "tenantId" -o tsv)
> ```
>
> ```bash
> # PowerShell
> $env:AZURE_TENANT_ID = az account show --query "tenantId" -o tsv
> ```
### Deploy apps to Azure
1. Make sure you're at the repository root.
```bash
cd $REPOSITORY_ROOT
```
1. Deploy the app.
```bash
azd up
```
While provisioning, you might be asked to enter environment name, Azure subscription and location.
### Run apps locally
1. Make sure you're at the repository root.
```bash
cd $REPOSITORY_ROOT
```
1. Run Aspire.
```bash
aspire run --project ./src/MafStarterPack.AppHost
```
## Resources
- [Microsoft Agent Framework](https://aka.ms/agent-framework)
- [Microsoft Foundry](https://aka.ms/microsoft-foundry)
- [Microsoft Foundry Agent Service](https://aka.ms/microsoft-foundry/agent-service)
- [Model Context Protocol (MCP)](https://modelcontextprotocol.io)
- [Aspire](https://aspire.dev)