base on Five lessons, learn how to really apply AI to your .NET Applications # 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: Foundry Local demos!** - Lesson 3 now features hands-on demos for [Foundry Local models](https://github.com/microsoft/Foundry-Local/tree/main). - See the official docs: [Foundry Local documentation](https://learn.microsoft.com/azure/ai-foundry/foundry-local/) - **Full explanation and code samples are available in [03-CoreGenerativeAITechniques/06-LocalModelRunners.md](./03-CoreGenerativeAITechniques/06-LocalModelRunners.md)** - **New: Azure OpenAI Sora Video Generation Demo!** - Lesson 3 now features a hands-on demo showing how to generate videos from text prompts using the new [Sora video generation model](https://learn.microsoft.com/azure/ai-services/openai/concepts/video-generation) in Azure OpenAI. - The sample demonstrates how to: - Submit a video generation job with a creative prompt. - Poll for job status and download the resulting video file automatically. - Save the generated video to your desktop for easy viewing. - See the official docs: [Azure OpenAI Sora video generation](https://learn.microsoft.com/azure/ai-services/openai/concepts/video-generation) - Find the sample in [Lesson 3: Core Generative AI Techniques /src/VideoGeneration-AzureSora-01/Program.cs](./03-CoreGenerativeAITechniques/src/VideoGeneration-AzureSora-01/Program.cs) - **New: Azure OpenAI Image Generation Model (`gpt-image-1`)**: Lesson 3 now features code samples for using the new Azure OpenAI image generation model, `gpt-image-1`. Learn how to generate images from .NET using the latest Azure OpenAI capabilities. - See the official: [How to use Azure OpenAI image generation models](https://learn.microsoft.com/azure/ai-services/openai/how-to/dall-e?tabs=gpt-image-1) and [openai-dotnet image generation guide](https://github.com/openai/openai-dotnet?tab=readme-ov-file#how-to-generate-images) for more details. - Find the sample in [Lesson 3: Core Generative AI Techniques .. /src/ImageGeneration-01.csproj](./03-CoreGenerativeAITechniques/src/ImageGeneration-01/ImageGeneration-01.csproj). - **New Scenario: Concurrent Agent Orchestration in eShopLite**: The [eShopLite repository](https://github.com/Azure-Samples/eShopLite/tree/main/scenarios/07-AgentsConcurrent) now features a scenario demonstrating concurrent agent orchestration using Semantic Kernel. This scenario showcases how multiple agents can work in parallel to analyze user queries and provide valuable insights for future analysis. [View all previous updates in our What's New section](./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) | <ul><li>Overview of generative models and their applications in .NET</li></ul> | | 02 | [**Setting Up for .NET Development with Generative AI**](./02-SetupDevEnvironment/readme.md) | <ul><li>Using libraries like **Microsoft.Extensions.AI** and **Semantic Kernel**.</li><li>Setup providers like GitHub Models, Azure AI Foundry, and local development like Ollama.</li></ul> | | 03 | [**Core Generative AI Techniques with .NET**](./03-CoreGenerativeAITechniques/readme.md) | <ul><li>Text generation and conversational flows.</li><li> Multimodal capabilities (vision and audio).</li><li>Agents</li></ul> | | 04 | [**Practical .NET Generative AI Samples**](./04-PracticalSamples/readme.md) | <ul><li>Complete samples demonstrating GenAI in real-life scenarios</li><li>Semantic search applications.</li><li>Multiple agent applications</li></ul> | | 05 | [**Responsible Use of Generative AI in .NET Apps**](./05-ResponsibleGenAI/readme.md) | <ul><li>Ethical considerations, bias mitigation, and secure implementations.</li></ul> | ## 🌐 Multi-Language Support | Language | Code | Link to Translated README | Last Updated | |----------------------|------|---------------------------------------------------------|--------------| | Chinese (Simplified) | zh | [Chinese Translation](./translations/zh/README.md) | 2025-06-11 | | Chinese (Traditional)| tw | [Chinese Translation](./translations/tw/README.md) | 2025-06-11 | | French | fr | [French Translation](./translations/fr/README.md) | 2025-06-11 | | Japanese | ja | [Japanese Translation](./translations/ja/README.md) | 2025-06-11 | | Korean | ko | [Korean Translation](./translations/ko/README.md) | 2025-06-11 | | Portuguese | pt | [Portuguese Translation](./translations/pt/README.md) | 2025-06-11 | | Spanish | es | [Spanish Translation](./translations/es/README.md) | 2025-06-11 | | German | de | [German Translation](./translations/de/README.md) | 2025-06-11 | > **Note:** All translations were updated to match the original content on **2025-06-11**. 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: - [Generative AI for Beginners](https://aka.ms/genai-beginners) - [Generative AI for Beginners .NET](https://aka.ms/genainet) - [Generative AI with JavaScript](https://aka.ms/genai-js-course) - [AI for Beginners](https://aka.ms/ai-beginners) - [AI Agents for Beginners - A Course](https://aka.ms/ai-agents-beginners) - [Data Science for Beginners](https://aka.ms/datascience-beginners) - [ML for Beginners](https://aka.ms/ml-beginners) - [Cybersecurity for Beginners](https://github.com/microsoft/Security-101) - [Web Dev for Beginners](https://aka.ms/webdev-beginners) - [IoT for Beginners](https://aka.ms/iot-beginners) - [XR Development for Beginners](https://github.com/microsoft/xr-development-for-beginners) - [Mastering GitHub Copilot for Paired Programming](https://github.com/microsoft/Mastering-GitHub-Copilot-for-Paired-Programming) - [Mastering GitHub Copilot for C#/.NET Developers](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers) - [Choose Your Own Copilot Adventure](https://github.com/microsoft/CopilotAdventures) - [Phi Cookbook: Hands-On Examples with Microsoft's Phi Models](https://aka.ms/phicookbook) [Let's start learning Generative AI and .NET!](02-SetupDevEnvironment/readme.md) 🚀 ", Assign "at most 3 tags" to the expected json: {"id":"13566","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"