Prerequisites ​
Complete these before the workshop. They are hard to fix once the day starts.
Required accounts ​
| Account | Why you need it | Cost |
|---|---|---|
| GitHub | Source control, the workshop repo, and GitHub Actions. | Free |
| Azure subscription | Hosting the model and (optionally) the site. | Free trial or pay-as-you-go |
| Microsoft Foundry | The 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 ​
| Tool | Version | Check command |
|---|---|---|
| Git | 2.40+ | git --version |
| Python | 3.12.x | python --version |
| Node.js | 20 LTS+ (LTS = Long-Term Support) | node --version |
| A code editor | latest | Visual 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.
git --versiongit --versionExpected output: git version 2.40.0 or higher.
python --versionpython --versionExpected output: Python 3.12.x (any 3.12 or newer).
node --versionnode --versionExpected 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.
- Go to dundermifflin.nl/repo and click Fork (top right on GitHub).
- Clone your fork:
git clone https://github.com/<your-github-username>/dm-ws.git
cd dm-wsgit clone https://github.com/<your-github-username>/dm-ws.git
cd dm-wsWhy 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, andnodeall report versions at or above the table above. - You have forked and cloned
https://dundermifflin.nl/reposuccessfully.
If any item fails, bring it to the room early, a facilitator will help, and the Troubleshooting page covers the most common issues.