Skip to content

Prerequisites ​

Complete these before the workshop. They are hard to fix once the day starts.

Required accounts ​

AccountWhy you need itCost
GitHubSource control, the workshop repo, and GitHub Actions.Free
Azure subscriptionHosting the model and (optionally) the site.Free trial or pay-as-you-go
Microsoft FoundryThe default place we run and manage the agent's model.Included with Azure

Don't have an Azure subscription yet?

Create a free account at https://azure.microsoft.com/free/ before the day. If account approval is pending, you can still follow along using our pre-deployed resources, or the observe path described in Defaults & paths.

Required local tools ​

ToolVersionCheck command
Git2.40+git --version
Python3.12.xpython --version
Node.js20 LTS+ (LTS = Long-Term Support)node --version
A code editorlatestVisual Studio Code recommended

Python version 3.12 is assumed

Feel free to use another version of Python, but the requirement files are tailored towards 3.12.x. If you run into requirement install challenges, you need to figure out supported versions for those packages for the specific Python version. Virtual environments make it easy to use Python 3.12

Use different Python version at your own risk

Pre-workshop checks ​

Run each command and confirm the output looks similar. Commands are copy-paste friendly.

bash
git --version
bash
git --version

Expected output: git version 2.40.0 or higher.

bash
python --version
bash
python --version

Expected output: Python 3.12.x (any 3.12 or newer).

bash
node --version
bash
node --version

Expected output: v20.x or higher.

Fork & clone the workshop repository ​

Clone your own fork of the attendee repo. This is the starting point for every lab.

  1. Go to dundermifflin.nl/repo and click Fork (top right on GitHub).
  2. Clone your fork:
bash
git clone https://github.com/<your-github-username>/dm-ws.git
cd dm-ws
bash
git clone https://github.com/<your-github-username>/dm-ws.git
cd dm-ws

Why fork?

The shared workshop repo is read-only for attendees. Your fork is yours — push, branch, and experiment freely without affecting anyone else.

If you see an error at this step, check that Git is installed and that you can reach GitHub from your network. The Troubleshooting page has a section for common clone failures.

Readiness checklist ​

You are ready for the day when:

  • You can sign in to GitHub.
  • You can sign in to the Azure portal.
  • git, python, and node all report versions at or above the table above.
  • You have forked and cloned https://dundermifflin.nl/repo successfully.

If any item fails, bring it to the room early, a facilitator will help, and the Troubleshooting page covers the most common issues.