# 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-01-24
## 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:
- **π€ NEW! 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 AgentFx Samples](./samples/AgentFx/CLAUDE-SAMPLES-README.md)
Plus a foundational Claude integration sample:
π [BasicChat with Claude via Microsoft Foundry](./samples/CoreSamples/BasicChat-11FoundryClaude/)
- **π AG-UI Integration Sample**
Check out our new Agent Framework sample demonstrating **AG-UI** (Agent Gateway User Interface) - the distributed agent architecture pattern! This sample shows how to:
- Separate AI agent backend from Blazor frontend for better scalability
- Use `AGUIChatClient` to communicate with remote agents over HTTP
- Implement RAG with semantic search and PDF document ingestion
- Orchestrate distributed applications with .NET Aspire
π [Explore the AG-UI Sample](./samples/AgentFx/AgentFx-AIWebChatApp-AG-UI/README.md)
- **π€ Microsoft Agent Framework (AgentFx) Lesson**
We've added a comprehensive new lesson on the Microsoft Agent Framework - the next evolution in .NET AI development! Learn how to:
- Build orchestrated AI agent systems with specialized roles
- Create multi-model workflows combining GitHub Models, Microsoft Foundry, and Ollama
- Integrate with Model Context Protocol (MCP) for enhanced capabilities
- Design sequential and concurrent agent workflows for complex tasks
π [Explore Lesson 06: Microsoft Agent Framework](./06-AgentFx/readme.md)
[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 like **GitHub Codespaces** and **GitHub Models** for seamless setup and fast time-to-code. But if you want to run the samples locally with your own models, you can totally do that too.
You'll learn how to implement Generative AI into .NET projects, from basic text generation to building full-fledged solutions using **GitHub Models**, **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 | [**Intro to Generative AI Basics for .NET Developers**](./01-IntroToGenAI/readme.md) | - Overview of generative models and their applications in .NET
|
| 02 | [**Setting Up for .NET Development with Generative AI**](./02-SetupDevEnvironment/readme.md) | - Using libraries like **Microsoft.Extensions.AI** and **Semantic Kernel**.
- Setup providers like GitHub Models, Microsoft Foundry, and local development like Ollama.
|
| 03 | [**Core Generative AI Techniques with .NET**](./03-CoreGenerativeAITechniques/readme.md) | - Text generation and conversational flows.
- Multimodal capabilities (vision and audio).
- Agents
|
| 04 | [**Practical .NET Generative AI Samples**](./04-PracticalSamples/readme.md) | - Complete samples demonstrating GenAI in real-life scenarios
- Semantic search applications.
- Multiple agent applications
|
| 05 | [**.NET Apps created using GenAI tools (aka: Vibe Coding Prompts)**](./05-AppCreatedWithGenAI/readme.md) | - Sample .NET apps generated using Generative AI tools like GitHub Copilot Agent.
- First sample: **Retro Invaders retro console game πΎ**
|
| 06 | [**Microsoft Agent Framework (AgentFx)**](./06-AgentFx/readme.md) | - Build powerful orchestrated AI agent systems.
- Multi-model agent workflows.
- Integration with Model Context Protocol (MCP).
|
| 07 | [**Responsible Use of Generative AI in .NET Apps**](./09-ResponsibleGenAI/readme.md) | - Ethical considerations, bias mitigation, and secure implementations.
|
## π 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).
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.
- **Leverage GitHub Models**: Try out AI-powered demos hosted directly within this repo, we explain more in the lessons, as we go. *(If you want to learn more about GitHub Models, click [here](https://docs.github.com/github-models))*
Then when you're ready to expand we also have guides for:
- Upgrading to **Azure OpenAI Services** for scalable and enterprise-ready solutions.
- Using **Ollama** to run models locally on your hardware for enhanced privacy and control.
## π€ 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:
### Azure / Edge / MCP / Agents
[](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst)
---
### 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)
---
### Copilot Series
[](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst)
[Let's start learning Generative AI and .NET!](02-SetupDevEnvironment/readme.md) π
## 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)