# Generative-AI-for-beginners-dotnet
**Repository Path**: mirrors_microsoft/Generative-AI-for-beginners-dotnet
## Basic Information
- **Project Name**: Generative-AI-for-beginners-dotnet
- **Description**: Five lessons, learn how to really apply AI to your .NET Applications
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-02-16
- **Last Updated**: 2026-03-07
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Generative AI for Beginners .NET - A Course
## Practical lessons teaching you how to build Generative AI applications in .NET
[](https://github.com/microsoft/Generative-AI-for-beginners-dotnet/blob/main/LICENSE)
[](https://github.com/microsoft/Generative-AI-For-Beginners-Dotnet/graphs/contributors/)
[](https://github.com/microsoft/Generative-AI-For-Beginners-Dotnet/issues/)
[](https://github.com/microsoft/Generative-AI-For-Beginners-Dotnet/pulls/)
[](http://makeapullrequest.com)
[](https://github.com/microsoft/Generative-AI-For-Beginners-Dotnet/watchers/)
[](https://github.com/microsoft/Generative-AI-For-Beginners-Dotnet/network/)
[](https://github.com/microsoft/Generative-AI-For-Beginners-Dotnet/stargazers/)
[](https://aka.ms/ai-discord/dotnet)
[](https://aka.ms/ai-discussions/dotnet)
Welcome to **Generative AI for Beginners .NET**, the hands-on course for .NET developers diving into the world of Generative AI!
This isnβt your typical βhereβs some theory, good luckβ course. This repository is all about **real-world applications** and **live coding** to empower .NET developers to take full advantage of Generative AI.
This is **hands-on**, **practical**, and designed to be **fun**!
Don't forget to [star (π) this repo](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars) to find it easier later.
β‘οΈGet your own copy by [Forking this repo](https://github.com/microsoft/Generative-AI-for-beginners-dotnet/fork) and find it next in your own repositories.
## β¨ What's New
We're constantly improving this course with the latest AI tools, models, and practical samples:
- **π Microsoft Agent Framework Reaches Release Candidate!**
[Microsoft Agent Framework](https://devblogs.microsoft.com/foundry/microsoft-agent-framework-reaches-release-candidate/) has reached **Release Candidate** (`1.0.0-rc1`) β a framework for building agents and multi-agent systems in .NET. Our samples are being migrated to the RC APIs. In the meantime, explore 25+ Agent Framework samples covering console apps, web chat, multi-agent workflows, and Foundry integration.
π [Explore the Agent Framework Samples](./samples/MAF/)
- **π€ Claude Models with Agent Framework**
Integrate **Claude models** from Microsoft Foundry with Microsoft Agent Framework! Three comprehensive samples demonstrate:
- Basic console chat with Claude using `ChatClientAgent`
- Conversation persistence with thread serialization/deserialization
- Interactive Blazor web chat application with modern UI
- Custom `ClaudeToOpenAIMessageHandler` for seamless API bridging
- Support for Claude Haiku, Sonnet, and Opus models
π [Explore the Claude MAF Samples](./samples/MAF/CLAUDE-SAMPLES-README.md)
Plus a foundational Claude integration sample:
π [BasicChat with Claude via Microsoft Foundry](./samples/CoreSamples/BasicChat-11FoundryClaude/)
[View all previous updates in our What's New archive](./10-WhatsNew/readme.md)
## π Introduction
Generative AI is transforming software development, and .NET is no exception. This course aims to simplify the journey by offering:
- Short 5-10 minute videos for each lesson.
- Fully functional .NET code samples you can run and explore.
- Integration with tools, including **GitHub Codespaces** for seamless setup and fast time-to-code. You can use **Azure OpenAI Services** / **Microsoft Foundry** or **Ollama** for local model hosting.
You'll learn how to implement Generative AI into .NET projects, from basic text generation to building full-fledged solutions using **Azure OpenAI Services** and **local models with Ollama**.
## π¦ Each Lesson Includes
- **Short Video**: A quick overview of the lesson (5-10 minutes).
- **Complete Code Samples**: Fully functional and ready to run.
- **Step-by-Step Guidance**: Simple instructions to help you learn and implement the concepts.
- **Deep Dive References**: This course focuses on the practical implementation of GenAI, to get deeper into the theoretical we also provide links to explanations in [Generative AI for Beginners - A Course](https://github.com/microsoft/generative-ai-for-beginners) when needed.
## ποΈ Lessons
| # | **Lesson Link** | **Description** |
| --- | --- | --- |
| 01 | [**Introduction to Generative AI**](./01-IntroductionToGenerativeAI/readme.md) | - What generative AI is and how it differs from traditional programming
- Why .NET is a first-class citizen for AI development
- The Microsoft AI stack and where each piece fits
- How to run samples in GitHub Codespaces or configure local development
|
| 02 | [**Generative AI Techniques**](./02-GenerativeAITechniques/readme.md) | - How to create chat conversations with context and memory
- How text embeddings work and why they matter
- How to process different content types including images and documents
- How to call AI models using Microsoft.Extensions.AI abstractions
|
| 03 | [**AI Patterns and Applications**](./03-AIPatternsAndApplications/readme.md) | - How to build semantic search that understands meaning
- How to implement retrieval augmented generation (RAG)
- How to create applications that process and understand documents
- When to use each pattern and how to combine them
|
| 04 | [**AI Agents with Microsoft Agent Framework**](./04-AgentsWithMAF/readme.md) | - What makes an agent different from a chatbot
- How to build agents that use tools and take actions
- How to orchestrate multiple agents working together
- How to integrate with Model Context Protocol (MCP)
|
| 05 | [**Responsible AI**](./05-ResponsibleAI/readme.md) | - How to identify and mitigate bias in AI applications
- How to implement content safety and guardrails
- How to build transparency and explainability into your systems
- Ethical considerations specific to agentic systems
|
## π Multi-Language Support
| Language | Code | Link to Translated README | Last Updated |
|----------------------|------|---------------------------------------------------------|--------------|
| Chinese (Simplified) | zh | [Chinese Translation](./translations/zh/README.md) | 2025-06-24 |
| Chinese (Traditional)| tw | [Chinese Translation](./translations/tw/README.md) | 2025-06-24 |
| French | fr | [French Translation](./translations/fr/README.md) | 2025-06-24 |
| Japanese | ja | [Japanese Translation](./translations/ja/README.md) | 2025-06-24 |
| Korean | ko | [Korean Translation](./translations/ko/README.md) | 2025-06-24 |
| Portuguese | pt | [Portuguese Translation](./translations/pt/README.md) | 2025-06-24 |
| Spanish | es | [Spanish Translation](./translations/es/README.md) | 2025-06-24 |
| German | de | [German Translation](./translations/de/README.md) | 2025-06-24 |
> **Note:** All translations were updated to match the original content on **2025-06-24**. See [PR #161](https://github.com/microsoft/Generative-AI-for-beginners-dotnet/pull/161) for details.
## π οΈ What You Need
To get started, you'll need:
1. A **GitHub account** (free is fine!) to [fork this entire repo](https://github.com/microsoft/generative-ai-for-beginners-dotnet/fork) to your own GitHub account.
1. **GitHub Codespaces enabled** for instant coding environments. You can enable GitHub Codespaces in your repository settings. Learn more about GitHub Codespaces [here](https://docs.github.com/en/codespaces).
1. Create your copy by [Forking this repo](https://github.com/microsoft/Generative-AI-for-beginners-dotnet/fork), or use the `Fork` button at the top of this page.
1. A basic understanding of **.NET development**. Learn more about .NET [here](https://dotnet.microsoft.com/learn/dotnet/what-is-dotnet).
1. **Azure Developer CLI (azd)** β [Install here](https://learn.microsoft.com/azure/developer/azure-developer-cli/install-azd?WT.mc_id=academic-105485-koreyst) (required for automated Azure setup)
1. An **Azure account** β [Create a free account here](https://azure.microsoft.com/free/?WT.mc_id=academic-105485-koreyst) (a free account works!)
And that's it.
We've designed this course to be as low-friction as possible. We make use of the following to help you get started quickly:
- **Run in GitHub Codespaces**: With one click, you'll get a pre-configured environment to test and explore the lessons.
- **Use Azure OpenAI / Microsoft Foundry**: Access powerful AI models through Azure for production-ready scenarios.
Then when you're ready to expand we also have guides for:
- Using **Ollama** to run models locally on your hardware for enhanced privacy and control.
---
## π Quick Start with Azure
### Automated Setup (Recommended)
For first-time Azure users, we provide an automated setup script that deploys all necessary resources:
```powershell
# Navigate to the repository root
cd Generative-AI-for-beginners-dotnet
# Run the setup script
./setup.ps1
```
This will:
- β
Deploy Azure OpenAI resources (gpt-5-mini, text-embedding-3-small)
- β
Create necessary storage and support services
- β
Configure .NET User Secrets automatically
- β
Display your Azure OpenAI endpoint and credentials
**For detailed instructions, see [Azure Resource Setup Guide](./01-IntroductionToGenerativeAI/setup-azure-openai.md?WT.mc_id=academic-105485-koreyst).**
---
## Manual Setup for Existing Azure Accounts
If you already have an Azure OpenAI account and the models deployed, configure secrets directly:
```powershell
# Set shared secrets (used by all samples)
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:Endpoint" "https://.openai.azure.com/"
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:Deployment" "gpt-5-mini"
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:EmbeddingDeployment" "text-embedding-3-small"
```
Then navigate to any sample and run:
```powershell
cd samples/CoreSamples/BasicChat-01MEAI
dotnet run app.cs
```
> **Note:** Azure OpenAI samples use `az login` for authentication. Run `az login` before running any Azure sample.
**For detailed manual setup options, see [Azure Resource Setup Guide](./01-IntroductionToGenerativeAI/setup-azure-openai.md?WT.mc_id=academic-105485-koreyst).**
---
## π§Ή Resource Cleanup
When you're done with the course, clean up Azure resources to avoid ongoing charges:
```powershell
./cleanup.ps1
```
This will:
- Delete all Azure resources
- Clear local configuration
- Remove User Secrets
**Learn more in [Azure Resource Setup Guide - Cleanup](./01-IntroductionToGenerativeAI/setup-azure-openai.md#resource-cleanup?WT.mc_id=academic-105485-koreyst).**
## π€ Want to Help?
Contributions are welcome! Here's how you can help:
- [Report issues](https://github.com/microsoft/Generative-AI-for-beginners-dotnet/issues/new) or bugs in the repo.
- Improve existing code samples or add new ones, fork this repo and propose some changes!
- Suggest additional lessons or enhancements.
- Do you have suggestions or found spelling or code errors?, [create a pull request](https://github.com/microsoft/Generative-AI-for-beginners-dotnet/compare)
Check the [CONTRIBUTING.MD](./CONTRIBUTING.MD) file for details on how to get involved.
## π License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
## π Other Courses
We have a lot of other content to help your learning journey. Check out:
### Generative AI Series
[](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst)
[-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst)
[-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst)
[-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst)
---
### Core Learning
[](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
[](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
[](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung)
[](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst)
[](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst)
## Getting Help
If you get stuck or have any questions about building AI apps, join:
[](https://aka.ms/foundry/discord)
If you have product feedback or errors while building visit:
[](https://aka.ms/foundry/forum)