Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Azure-Samples/azd-ai-starter
Creates an Azure AI Service and deploys the specified models.
https://github.com/Azure-Samples/azd-ai-starter
azd-templates azure
Last synced: 3 months ago
JSON representation
Creates an Azure AI Service and deploys the specified models.
- Host: GitHub
- URL: https://github.com/Azure-Samples/azd-ai-starter
- Owner: Azure-Samples
- License: mit
- Created: 2024-05-02T17:09:57.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-10-21T21:55:39.000Z (3 months ago)
- Last Synced: 2024-10-22T17:46:29.745Z (3 months ago)
- Topics: azd-templates, azure
- Language: PowerShell
- Homepage:
- Size: 145 KB
- Stars: 12
- Watchers: 14
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.MD
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
---
page_type: sample
languages:
- azdeveloper
- bicep
products:
- azure
urlFragment: azd-ai-starter
name: Azure AI starter template
description: Creates an Azure AI Service and deploys the specified models.
---
> [!NOTE]
> This repository is a starter kit to use as a base to build templates for AI powered applications. It has all the necessary artifact to conform with [standards](https://github.com/Azure-Samples/azd-template-artifacts) and pass the mandatory validation for [publication](https://github.com/Azure-Samples/azd-template-artifacts/blob/main/publishing-guidelines.md) as part of our official collections. If you want to automatically scaffold a template based on this one, instead of cloning it, you can use the [Azure Developer CLI](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/) and run `azd init -t azd-ai-starter`
> [!IMPORTANT]
> The content below represents a standard readme file defining the required structure for template validation. Update as required, including replacing all instances of [Project Name] with your project's name, and remove this notice and the notice and metadata above.
# [Project Name]
[](placeholder)
[](placeholder)
(Longer Description, as compared to the GitHub "about" section of the project)
(make sure to highlight the use case!)
Sample application code is included in this project. You can use or modify this app code or you can rip it out and include your own.
[Features](#features) • [Gettting Started](#getting-started) • [Guidance](#guidance)
(include a screenshot of your template's endpoint here-- so users know what it should look like when they're done)
## Features
This project framework provides the following features:
* Feature 1
* Feature 2
* ...
### Architecture Diagram
Include a diagram describing the application. You can take [this image](https://raw.githubusercontent.com/Azure-Samples/serverless-chat-langchainjs/main/docs/images/architecture.drawio.png) as a reference.
### Demo Video (optional)
(Embed demo video here)
## Getting Started
You have a few options for getting started with this template. The quickest way to get started is [GitHub Codespaces](#github-codespaces), since it will setup all the tools for you, but you can also [set it up locally](#local-environment). You can also use a [VS Code dev container](#vs-code-dev-containers)
This template uses [MODEL 1] and [MODEL 2] which may not be available in all Azure regions. Check for [up-to-date region availability](https://learn.microsoft.com/azure/ai-services/openai/concepts/models#standard-deployment-model-availability) and select a region during deployment accordingly
* We recommend using [SUGGESTED REGION]
### GitHub Codespaces
You can run this template virtually by using GitHub Codespaces. The button will open a web-based VS Code instance in your browser:
1. Open the template (this may take several minutes)
[](placeholder)
2. Open a terminal window
3. Sign into your Azure account:
```shell
azd auth login --use-device-code
```
4. [any other steps needed for your template]
5. Provision the Azure resources and deploy your code:
```shell
azd up
```
6. (Add steps to start up the sample app)
### VS Code Dev Containers
A related option is VS Code Dev Containers, which will open the project in your local VS Code using the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers):
1. Start Docker Desktop (install it if not already installed)
2. Open the project:
[](placeholder)
3. In the VS Code window that opens, once the project files show up (this may take several minutes), open a terminal window.
4. Sign into your Azure account:
```shell
azd auth login
```
5. [any other steps needed for your template]
6. Provision the Azure resources and deploy your code:
```shell
azd up
```
7. (Add steps to start up the sample app)
8. Configure a CI/CD pipeline:
```shell
azd pipeline config
```
### Local Environment
### Prerequisites
(ideally very short, if any)
* Install [azd](https://aka.ms/install-azd)
* Windows: `winget install microsoft.azd`
* Linux: `curl -fsSL https://aka.ms/install-azd.sh | bash`
* MacOS: `brew tap azure/azd && brew install azd`
* OS
* Library version
* This template uses [MODEL 1] and [MODEL 2] which may not be available in all Azure regions. Check for [up-to-date region availability](https://learn.microsoft.com/azure/ai-services/openai/concepts/models#standard-deployment-model-availability) and select a region during deployment accordingly
* We recommend using [SUGGESTED REGION]
* ...
### Installation
(ideally very short)
* list of any prerequisites
* ...
## Quickstart
(Add steps to get up and running quickly)
1. Bring down the template code:
```shell
azd init --template [name-of-repo]
```
This will perform a git clone
2. Sign into your Azure account:
```shell
azd auth login
```
3. [Packages or anything else that needs to be installed]
```shell
npm install ...
```
4. ...
5. Provision and deploy the project to Azure:
```shell
azd up
```
6. (Add steps to start up the sample app)
7. Configure a CI/CD pipeline:
```shell
azd pipeline config
```
### Local Development
Describe how to run and develop the app
### Extending Bicep IaC files
Once the application is developed, the Bicep files may need to be extended with additional service modules and configuration. We include a script to list the available API versions for each service, including an indicator for latest stable releases.
To use it, change directory to the [scripts folder](./scripts), and locate and run the script called `listAPIVersions`, for your corresponding platform.
> [!IMPORTANT]
> This script needs the [Azure CLI] to be installed in your system or available in your setup.
## Guidance
### Region Availability
This template uses [MODEL 1] and [MODEL 2] which may not be available in all Azure regions. Check for [up-to-date region availability](https://learn.microsoft.com/azure/ai-services/openai/concepts/models#standard-deployment-model-availability) and select a region during deployment accordingly
* We recommend using [SUGGESTED REGION]
### Quotas
Apart from making sure the selected model is available in a preferred region, you may need to make sure your subscription has remaining quota available. We provide a tool, in the form of a script, for this purpose.
To use it, change directory to the [scripts folder](./scripts), and locate and run the script called `listAIQuotas`, for your corresponding platform.
> [!IMPORTANT]
> This script needs the [Azure CLI] to be installed in your system or available in your setup.
### Costs
You can estimate the cost of this project's architecture with [Azure's pricing calculator](https://azure.microsoft.com/pricing/calculator/)
* [Azure Product] - [plan type] [link to pricing for product](https://azure.microsoft.com/pricing/)
### Security
> [!NOTE]
> When implementing this template please specify whether the template uses Managed Identity or Key Vault
This template has either [Managed Identity](https://learn.microsoft.com/entra/identity/managed-identities-azure-resources/overview) or Key Vault built in to eliminate the need for developers to manage these credentials. Applications can use managed identities to obtain Microsoft Entra tokens without having to manage any credentials. Additionally, we have added a [GitHub Action tool](https://github.com/microsoft/security-devops-action) that scans the infrastructure-as-code files and generates a report containing any detected issues. To ensure best practices in your repo we recommend anyone creating solutions based on our templates ensure that the [Github secret scanning](https://docs.github.com/code-security/secret-scanning/about-secret-scanning) setting is enabled in your repos.
### Resources
(Any additional resources or related projects)
* Link to supporting information
* Link to similar sample
* [Develop Python apps that use Azure AI services](https://learn.microsoft.com/azure/developer/python/azure-ai-for-python-developers)
* ...