# Awesome azd

> A gallery of Azure Developer CLI (azd) templates, Foundry agent
> examples, and azd extensions from Microsoft and the community.

## Machine-readable catalogs

- [Templates](https://azure.github.io/awesome-azd/templates.json):
  Gallery entries with descriptions, source URLs, and optional language,
  framework, Azure service, and infrastructure-as-code tags.
- [Agent templates](https://azure.github.io/awesome-azd/templates.json):
  Foundry agent examples in the shared catalog, identified by
  `templateType: "extension.ai.agent"`, with manifest URLs.
- [Extensions](https://azure.github.io/awesome-azd/extensions.json):
  azd extension metadata, capabilities, and supported platforms.

## Guidance for agents

- Use the catalogs to find candidates; check their source repositories
  for current requirements, deployment instructions, and status.
- In templates.json, entries with `templateType: "extension.ai.agent"`
  are agent manifests, not standard azd templates. Do not recommend
  their manifest URLs as input to `azd init -t`.
- Missing metadata does not mean a template lacks that feature.
- Standard azd templates are typically initialized with
  `azd init -t <template-repository-url>` and deployed with `azd up`.
  Check the template README before recommending commands.
- Azure deployment can create billable resources; ask for user approval
  before running deployment commands.

## Links

- [Template gallery](https://azure.github.io/awesome-azd/templates/)
- [Contributor guide](https://azure.github.io/awesome-azd/docs/contribute/)
- [Azure Developer CLI documentation](https://learn.microsoft.com/azure/developer/azure-developer-cli/overview).