# ForBeginners

**Repository Path**: mirrors_microsoft/ForBeginners

## Basic Information

- **Project Name**: ForBeginners
- **Description**: The "For Beginners" template provides a starter repository for building workshops or curricula with a hosted Mkdocs website that complies with Microsoft OSS requirements
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-15
- **Last Updated**: 2025-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


<div style="background: linear-gradient(90deg, #4C1D95 0%, #1E40AF 25%, #0EA5E9 50%, #06B6D4 75%, #87CEEB 100%); padding: 20px 20px; border-radius: 10px; margin: 20px 0;">
  <h1 style="color: white; text-align: center; margin: 0; font-size: 2em; text-shadow: 2px 2px 4px rgba(0,0,0,0.3);">
    For Beginners: An AZD Project
  </h1>
  <p style="color: white; text-align: center; margin: 0 0 0 0; font-size: 1em; opacity: 0.9;">
   A customized "Getting Started with AI Agents" template for learners
  </p>
</div>



> [!IMPORTANT]
>
> 🚨 **This repository is under active development and is not meant for public use - yet. This notice will be removed once we hit a stable version (ETA: Oct 17, 2025). Please wait to file issues until that time.**

## For Beginners: Template

This project contains setup scripts and a customized version of the [get-started-with-ai-agents](https://github.com/Azure-Samples/get-started-with-ai-agents/tree/main) starter template for Azure AI Foundry.

Our objectives are: 

1. Create scripts to customize the base template for our 1P workshops (with Skillable)
1. Maintain a customized template for reuse in our {AZD/Models}-For-Beginners curricula
1. Maintain event-specific branches that freeze stable versions for a given workshop.

Note that this means the version of the template here may be different from the base starter template in terms of the default configuration used.

_We encourage the community to fork and extend this repository for their own Azure AI Foundry workshops or learning journeys - and file issues with bugs or feedback._

## AZD For Beginners: Workshop

Not familiar with [AZD templates](https://learn.microsoft.com/azure/developer/azure-developer-cli/azd-templates?tabs=csharp)? Explore the new [AZD For Beginners](https://github.com/microsoft/azd-for-beginners) curriculum for a step-by-step introduction to the [Azure Developer CLI](https://aka.ms/azd) and fundamentals of AZD templates.

This _For Beginners Template_ project also powers the [AZD For AI Developers](https://github.com/microsoft/AZD-for-beginners/tree/main/workshop) workshop that is part of that curriculum. This of this template as a _learning sandbox_ where you can deconstruct a completely functioning template to figure out how it works. Then reconstruct it with your data, and customize it to your specific scenario or requirements!

## Related Resources

1. [Azure Developer CLI](https://learn.microsoft.com/azure/developer/azure-developer-cli/) - documentation & reference
1. [Awesome AZD](https://aka.ms/awesome-azd) - template gallery for Azure
1. [AI App Templates](https://ai.azure.com/templates) - curated for Azure AI Foundry
1. [AZD For Beginners](https://github.com/microsoft/azd-for-beginners) - open-source curriculum 



## Contributing

This project welcomes contributions and suggestions.  Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

## Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft