Run Docker, the game, and Rasa in a cloud dev environment, from your browser
Prof. Fred Agbo
2026-11-01
🧑💻 Your lab computer in the cloud
AI 380: Human-AI Interaction · Willamette University
A codespace is a ready-to-use Linux machine with VS Code, running in the cloud and attached to your GitHub repo.
No installs on your laptop
Docker and Python ready to go
Everyone gets the same setup
🛠️ How to use this walkthrough
Read the concept.
Do the step in your browser.
Pass the checkpoint.
Continue only when it passes.
You need: A GitHub account and the Calm_Wordle repo already pushed to GitHub (see the Azure workshop, Part 3).
🗺️ What Codespaces does
flowchart LR
A["🐙 GitHub repo<br/>+ .devcontainer"] -->|"Create codespace"| B
subgraph B ["☁️ Cloud Linux machine"]
C["📝 VS Code<br/>in the browser"]
D["🐳 Docker + Python"]
E["🎮 Game :8000<br/>🤖 Rasa :5005"]
end
B -->|"forwarded HTTPS port"| F["💻 Your browser"]
📊 What it is good for
Good for
Not good for
Labs and class demos
An always-on public website
Same environment for every student
Anything that must keep running overnight
Running Docker and Rasa without local installs
Large, long jobs that burn your free hours
Trying the game over HTTPS (microphone works)
Serving the grader a link days later
A codespace stops when idle. For a site that must stay online, use a host from the Azure workshop.
💰 Free allowance
Resource
Free personal allowance (approx.)
Compute
About 120 core hours per month
Storage
About 15 GB-months per month
Core hours scale with machine size: a 2-core machine gives about 60 hours, a 4-core about 30.
Idle codespaces stop after 30 minutes by default.
Check GitHub’s current limits before class; they change.
① Create and open
Part 1 · Launch, look around, stop
Repo → codespace → browser editor
🚀 Part 1 · Create a codespace
Open your Calm_Wordle repo on github.com.
Click the green Code button.
Choose the Codespaces tab.
Click Create codespace on main.
A new browser tab opens and builds the environment. The first build takes a few minutes.
🧭 Part 1 · Find your way around
Area
What it is
Explorer (left)
Your repo files
Editor (center)
Edit code like in desktop VS Code
Terminal (bottom)
A Linux shell inside the cloud machine
Ports tab (bottom)
Web servers running in the codespace
Bottom-left badge
Codespace name; click for stop and rebuild options
✅ Part 1 · Check the tools
In the terminal:
docker--versionpython--versiongit status
Checkpoint 1: All three commands run. If docker is missing, continue to Part 2; the dev container fixes it.
② Make it repeatable
Part 2 · Dev container and secrets
One file tells every student’s codespace what to install
🧱 Part 2 · The dev container
A dev container is a description of the environment, stored in the repo. Create: