microsoft/ai-agents-for-beginners

Python

11 environment variables found in .env.example

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.

AZURE_AI_PROJECT_ENDPOINT secret Azure AI Foundry Project (Required for most lessons) Your Azure AI Foundry project endpoint
AZURE_AI_MODEL_DEPLOYMENT_NAME secret Model deployment name in your Foundry project (e.g., gpt-4o)
AZURE_SEARCH_SERVICE_ENDPOINT secret Azure AI Search (Required for Lesson 05 Agentic RAG)
AZURE_SEARCH_API_KEY secret
GITHUB_TOKEN secret GitHub Models (Required for Lesson 06 and Lesson 08 GitHub Models workflows)
GITHUB_ENDPOINT
GITHUB_MODEL_ID
BING_CONNECTION_ID Azure AI Bing Connection (Required for Lesson 08 Bing grounding workflow)
MINIMAX_API_KEY secret MiniMax (Alternative OpenAI-compatible provider) MiniMax offers large-context models (up to 204K tokens) via an OpenAI-compatible API. Get…
MINIMAX_BASE_URL
MINIMAX_MODEL_ID

Best match Fly.io Anything Dockerized — requires the Fly CLI.

macOS

brew install flyctl && fly launch --from https://github.com/microsoft/ai-agents-for-beginners

Linux

curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/microsoft/ai-agents-for-beginners

Windows (PowerShell)

iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/microsoft/ai-agents-for-beginners

Or deploy to a different host