LLM AGENTS WORKSHOP · SETUP GUIDE

Set Up Your Workshop Environment

Get Python, a virtual environment, and the 14-demo pack ready before Day 1. Every demo also runs fully offline, so venue wifi is never a blocker.

Python 3.10+·Runs fully offline·14 hands-on demos
What you'll build · Workshop topics10 topics
Python 3.10+Core runtime
Claude APIAnthropic SDK
OpenRouterAlternate provider
MCPTools via a server
RAGEmbeddings + retrieval
AgentsReAct loop + tools
Multi-agentPipelines & hand-offs
Voice agentSTT to LLM to TTS
GuardrailsPII + output checks
MOCK_MODERuns with no API key
Setup Guide · LLM Agents Workshop

Get your machine ready
in about 15 minutes.

Everything for the hands-on demos — Python, a virtual environment, and the 14-demo pack. Seven short steps, and every demo also runs offline, so venue wifi can't block you.

Hover a line to learn more

setup.sh
1# Step 1 — Install Python 3.10+ (python.org, tick "Add python.exe to PATH")
2py --version # Windows
3python3 --version # macOS / Linux
4 
5# Step 2 — Enter the demo pack you downloaded from Google Drive
6cd SHCTPT_Workshop_09_09_2026
7 
8# Step 3 — Create a virtual environment
9py -m venv .venv # Windows
10python3 -m venv venv # macOS / Linux
11 
12# Step 4 — Activate it (run again in every new terminal)
13.venv\Scripts\Activate.ps1 # Windows PowerShell
14.venv\Scripts\activate.ps1 # use this if Activate.ps1 does not work
15source venv/bin/activate # macOS / Linux
16 
17# Step 5 — Install everything the 14 demos need
18pip install -r requirements-all.txt
19 
20# Step 6 — (Optional) API key for the live demos 05-13
21copy .env.example .env # macOS / Linux: cp .env.example .env
22# then paste ONE key: ANTHROPIC_API_KEY — or — OPENROUTER_API_KEY
23 
24# Step 7 — Verify with a demo that needs no key
25cd 01-Basic-AI-Example
26pip install -r requirements.txt
27python rule_based_bot.py
28 
29# See output in the terminal? Your machine is workshop-ready.

Six steps. About fifteen minutes.

The whole toolchain fits in one virtual environment. Below is each step, why it matters, and how to check it worked before Day 1.

01

Python 3.10 or newer

Everything runs on Python. Install it from python.org — not the Microsoft Store — and on Windows tick "Add python.exe to PATH" on the first screen. On Windows use the py launcher; python3 there opens the Store instead of running.

Verify
$ py --version
Python 3.12.4
$ pip --version
pip 24.x from ...
02

The workshop demo pack

Download the shared Google Drive folder and unzip it somewhere easy to reach. It holds 14 self-contained demos (00 to 13), a combined requirements-all.txt, and per-demo notes. Open a terminal inside that folder — every command below runs from there.

Contents
$ cd SHCTPT_Workshop_09_09_2026
$ ls
00-Setup 01-Basic-AI-Example
... 13-Agent-Framework-Chat-UI
03

Virtual environment

Keeps the workshop packages separate from your system Python. Create it once, then activate it in every new terminal. On Windows PowerShell try Activate.ps1 first; if that does not work, use the lower-case activate.ps1. If PowerShell blocks the script, run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned once.

Activate
PS> .venv\Scripts\Activate.ps1
PS> .venv\Scripts\activate.ps1
$ source venv/bin/activate
(.venv) $
04

Install dependencies

One command pulls every package the 14 demos use — anthropic, openai, mcp, flask, fastapi, scikit-learn, tiktoken and more. Each demo folder also has its own requirements.txt if you would rather install per demo.

Install
$ pip install -r requirements-all.txt
Collecting anthropic ...
Collecting openai ...
Successfully installed
05

API key · optional

Every demo runs offline in MOCK_MODE with no key. Add one only to see real model responses in demos 05 to 13. Copy .env.example to .env inside that demo folder and fill in ONE provider — Anthropic (ANTHROPIC_API_KEY) or OpenRouter (OPENROUTER_API_KEY). Never commit a real .env.

Configure
$ copy .env.example .env
# ANTHROPIC_API_KEY=sk-ant-...
# — or —
# OPENROUTER_API_KEY=sk-or-...
06

Run a demo to verify

Pick a demo that needs no key, install its requirements, and run the script named in its README. Output in the terminal means your environment is ready for Day 1. Re-run each demo you plan to follow along with at least once beforehand.

Smoke test
$ cd 01-Basic-AI-Example
$ pip install -r requirements.txt
$ python rule_based_bot.py
Bot: hi there (rule-based)

All commands, ready to paste.

Run these in order in your terminal. Each line is individually copyable. Use the Windows or the macOS / Linux line for your machine.

Check Python — Windows

py --version

Check Python — macOS / Linux

python3 --version

Enter the demo pack

cd SHCTPT_Workshop_09_09_2026

Create virtual env — Windows

py -m venv .venv

Create virtual env — macOS / Linux

python3 -m venv venv

Activate — Windows PowerShell

.venv\Scripts\Activate.ps1

Activate — Windows PowerShell (lower-case — use if Activate.ps1 fails)

.venv\Scripts\activate.ps1

Activate — Windows CMD

.venv\Scripts\activate.bat

Activate — macOS / Linux

source venv/bin/activate

Install all dependencies

pip install -r requirements-all.txt

Copy the env template — Windows

copy .env.example .env

Copy the env template — macOS / Linux

cp .env.example .env

Verify — run a demo that needs no key

python rule_based_bot.py

Need help? Bring your laptop to the venue at least 20 minutes early. The team will help with any setup issues before the first session. If the network is flaky, every demo still runs in MOCK_MODE with no API key.