Before the workshop

Get ready for day 1

About 20 minutes, a few days ahead: install three tools, sign in to AWS and run one check. Whatever fails here would otherwise cost you the first hour of the workshop.

  1. Install the tools

  2. Clone and configure

    terminal
    git clone --branch bootcamp-participant --single-branch https://github.com/Opsfleet/agentic-workshop-aws.git datastream-bootcamp
    cd datastream-bootcamp
    uv sync
    terminal · macOS / Linux
    cp .env.example .env
    terminal · Windows PowerShell
    copy .env.example .env

    In .env set PARTICIPANT to the name your instructor gave you and AWS_PROFILE=bootcamp.

  3. Sign in to AWS

    terminal
    aws configure sso          # start URL and region from your instructor; profile name: bootcamp
    aws sso login --profile bootcamp
  4. Run the pre-flight check

    terminal
    uv run bootcamp.py doctor

    It creates nothing, costs a fraction of a cent (one tiny model call) and finishes in seconds. Every line should start with ✔; send the output to your instructor either way.

    terminal · expected outputread only
    Checking this laptop for the bootcamp (up to ~30 s; nothing is created)...
    ✔ Operating system: macOS 15.5 (arm64)
    ✔ Python: 3.13.13
    ✔ uv: uv 0.11.8
    ✔ Terraform: Terraform v1.15.0 (>= 1.9)
    ✔ AWS CLI: aws-cli/2.34.40
    ✔ Disk space: 163.7 GiB free
    ✔ AWS credentials: arn:aws:sts::123456789012:assumed-role/AWSReservedSSO_Bootcamp_0123/you@example.com (from bootcamp)
    ✔ .env PARTICIPANT: alice (.env), region us-east-1
    ✔ Participant role: assumed bootcamp-participant-alice in us-east-1
    ✔ Gateway settings: https://llm.bootcamp.example.com
    ✔ LiteLLM call: gpt-6-luna answered in 1.0 s
    ✔ LiteLLM budget: $1.0000 left of $1
    ✔ Bedrock: direct Bedrock is denied, as designed (models go through LiteLLM)
    ✔ Network: Cognito: https://cognito-idp.us-east-1.amazonaws.com/ answered HTTP 400
    ✔ Network: National Weather Service: https://api.weather.gov/ answered HTTP 200
    ✔ Network: GitHub: https://github.com/ answered HTTP 200
    
    16 pass. Ready for day 1.

When a line fails

CheckUsually meansFix
Terraform, AWS CLI, uvNot installed or too oldInstall from the links above, open a new terminal
AWS credentialsYour SSO session expired or AWS_PROFILE is wrongaws sso login --profile bootcamp
.env PARTICIPANTBlank or malformed nameSet the name your instructor gave you in .env
Participant roleYour name is not on the deployed roster, or SSO may not assume rolesCheck the spelling, then tell your instructor
Gateway settingsWrong region, or your key was not synced yetCheck BOOTCAMP_REGION, then tell your instructor
LiteLLM call / budgetGateway unreachable, or your budget is used upCheck VPN/proxy, then tell your instructor
BedrockWARN only: direct Bedrock should be deniedTell your instructor (nothing to fix on your side)
NetworkA proxy or firewall blocks an HTTPS hostAsk IT to allow the hosts listed below

Corporate networks

Behind a proxy or firewall, HTTPS must reach:

  • Cognito: https://cognito-idp.<region>.amazonaws.com/
  • National Weather Service: https://api.weather.gov/
  • GitHub: https://github.com/
  • AWS APIs (*.amazonaws.com), the bootcamp gateway and site your instructor shares
  • Python packages and Terraform providers (pypi.org, files.pythonhosted.org, registry.terraform.io, releases.hashicorp.com)

Stuck? Run uv run bootcamp.py doctor --verbose and send the output to your instructor before the workshop.