👩‍🏫

Linux Adventure WorkshopTaller de Aventura Linux

Instructor GuideGuía del Instructor

Everything you need to run a great workshop.Todo lo que necesitás para dar un gran taller.

📊 Workshop at a GlanceTaller de un Vistazo

30 minDurationDuración

24–37Students (ages 11–13)Estudiantes (11–13 años)

25Laptops

1–2Per LaptopPor Laptop

⏱️ Timeline⏱️ Cronograma

TimeHora	DurationDuración	ActivityActividad	Key CommandsComandos Clave
0:00	2 min	Welcome & IntroBienvenida e Intro	Welcome slides (8 slides)Diapositivas de bienvenida (8)
0:02	8 min	🗺️ Treasure Hunt🗺️ Búsqueda del Tesoro	`ls`, `cd`, `cat`, `ls -a`
0:10	8 min	🤖 Robot Factory🤖 Fábrica de Robots	`touch`, `mv`, `wc -l`
0:18	5 min	🎮 Terminal Playground🎮 Zona de Juegos	`cowsay`, `sl`, `cmatrix`
0:23	7 min	📝 First Script📝 Primer Script	`nano`, `bash`
0:30	—	🏁 Wrap-up🏁 Cierre	Celebration & key messageCelebración y mensaje clave

🔍 Command Detective is a bonus activity for groups that finish early. It uses grep to search through evidence files — great for curious/advanced students. 🔍 Detective de Comandos es una actividad extra para grupos que terminen rápido. Usa grep para buscar en archivos de evidencia — ideal para estudiantes curiosos/avanzados.

🚀 Before the Workshop — Deploy ScriptsAntes del Taller — Instalar Scripts Do this first!¡Hacer primero!

Run one command in PowerShell on each laptop. It does everything automatically:Ejecutá un comando en PowerShell en cada laptop. Hace todo automáticamente:

🐧 All-in-One Installer — `install-workshop.ps1`🐧 Instalador Todo-en-Uno — `install-workshop.ps1`

This single script handles the entire setup:Este script maneja toda la configuración:

Installs WSL + Ubuntu (skips if already installed; reboots if needed)Instala WSL + Ubuntu (se salta si ya está instalado; reinicia si es necesario)
Creates activity folders in ~/linux-adventure/ (setup.sh)Crea carpetas de actividades en ~/linux-adventure/ y ~/aventura-linux/ (setup.sh)
Installs fun tools — cowsay, sl, cmatrix, figlet (setup-fun.sh)Instala herramientas divertidas — cowsay, sl, cmatrix, figlet (setup-fun.sh)
Creates a 🐧 Tux desktop shortcut that opens Edge + Ubuntu side by sideCrea un acceso directo 🐧 Tux que abre Edge + Ubuntu lado a lado

Open PowerShell (as Admin) and run:Abrí PowerShell (como Admin) y ejecutá:

irm https://linux.brenes.info/install-workshop.ps1 | iex

If WSL wasn't installed: The script will install it, ask you to reboot, and then you run the same command again to finish.Si WSL no estaba instalado: El script lo instalará, te pedirá reiniciar, y luego ejecutás el mismo comando de nuevo para terminar.

💡 Safe to re-run. The installer skips steps that are already done. If a laptop needs a reset, just run it again. 💡 Se puede ejecutar de nuevo sin problema. El instalador se salta pasos ya completados. Si una laptop necesita reinicio, solo volvé a ejecutarlo.

⚠️ No internet at the school? Run the installer at home/office on each laptop beforehand. The script downloads everything it needs from GitHub.

USB alternative: Download the repo files to a USB drive, then run from PowerShell: ⚠️ ¿Sin internet en la escuela? Ejecutá el instalador en casa/oficina en cada laptop de antemano. El script descarga todo lo necesario de GitHub.

Alternativa USB: Descargá los archivos del repo a una USB, y ejecutá desde PowerShell:

powershell -ExecutionPolicy Bypass -File "D:\install-workshop.ps1"

✅ Pre-Flight Checklist✅ Lista de Verificación

#	TaskTarea	Check✓
1	Installer ran successfully on every laptop — `irm ... \| iex`El instalador se ejecutó con éxito en cada laptop — `irm ... \| iex`	☐
2	Ubuntu (WSL) opens from the Start menu on every laptopUbuntu (WSL) abre desde el menú Inicio en cada laptop	☐
3	`ls ~/linux-adventure/` shows 5 folders and `cowsay "test"` works`ls ~/aventura-linux/` muestra 5 carpetas y `cowsay "test"` funciona	☐
4	🐧 "Linux Adventure Workshop" shortcut is on the Desktop — click it to open Edge (workshop site) + Windows Terminal (Ubuntu) side by side🐧 El acceso directo "Linux Adventure Workshop" está en el Escritorio — click para abrir Edge (sitio del taller) + Terminal de Windows (Ubuntu) lado a lado	☐
5	Student guides printed (1 per group) or displayed on projectorGuías de estudiante impresas (1 por grupo) o en el proyector	☐
6	Welcome slides loaded on projector — linux.brenes.info/welcome.htmlDiapositivas de bienvenida cargadas en el proyector — linux.brenes.info/welcome.html	☐
7	This instructor guide is open on your deviceEsta guía de instructor está abierta en tu dispositivo	☐

🎤 Welcome ScriptGuión de Bienvenida 2 minutesminutos

Open the Welcome Slides full-screen on the projector before students arrive:Abrí las Diapositivas de Bienvenida en pantalla completa en el proyector antes de que lleguen los estudiantes:

🖥️ Welcome Slides🖥️ Diapositivas de Bienvenida

8 slides, ~2 minutes. Use arrow keys or spacebar to advance.8 diapositivas, ~2 minutos. Usá las flechas o la barra espaciadora para avanzar.

linux.brenes.info/welcome.html

Slide order:Orden de diapositivas:

Title — "Linux Adventure Workshop" with penguinTítulo — "Taller de Aventura Linux" con pingüino
What is Open Source — Closed vs Open comparisonQué es Open Source — Comparación Cerrado vs Abierto
Linux runs almost everything — 10-card grid (phones, cars, space, Azure…)Linux está en casi todo — Grilla de 10 (teléfonos, carros, espacio, Azure…)
Linux by the numbers — stat bars (supercomputers 100%, cloud 90%+, etc.)Linux en números — barras de estadísticas (supercomputadoras 100%, nube 90%+, etc.)
Even Microsoft uses Linux — Azure Linux, WSL, GitHub, AI infrastructureHasta Microsoft usa Linux — Azure Linux, WSL, GitHub, infraestructura de IA
Look around this room — phone, router, laptop, websitesMirá alrededor del salón — celular, router, laptop, sitios web
Why should you care — game devs, AI, security, NASA¿Por qué debería importarte? — videojuegos, IA, seguridad, NASA
Ready? — terminal prompt with blinking cursor¿Listos? — prompt de terminal con cursor parpadeante

💡 Delivery tip: Don't read the slides. Let the visuals speak. Add energy with your voice: "Raise your hand if you have an Android phone — guess what, you're already running Linux!" 💡 Tip de presentación: No leás las diapositivas. Dejá que los visuales hablen. Agregá energía con tu voz: "Levanten la mano si tienen un celular Android — ¿adivinen qué? ¡Ya están usando Linux!"

After slide 8, immediately:Después de la diapositiva 8, inmediatamente:

Make sure every group has Ubuntu openAsegurate de que cada grupo tenga Ubuntu abierto
Have them type cd ~ then cd linux-adventure and press EnterQue escriban cd ~ luego cd aventura-linux y presionen Enter
Start Activity 1!¡Empezá la Actividad 1!

💡 Energy tip: Don't over-explain. Kids learn by doing. Get them into Activity 1 as fast as possible. 💡 Tip de energía: No expliqués de más. Los chicos aprenden haciendo. Metelos en la Actividad 1 lo más rápido posible.

📋 Activity-by-Activity TipsTips por Actividad

🗺️ Treasure Hunt🗺️ Búsqueda del Tesoro 8 min

Goal:Meta: Navigate folders and find hidden cluesNavegar carpetas y encontrar pistas ocultas

Key commands:Comandos clave: ls, ls -a, cd, cat

Big reveal: The treasure is a hidden file (.treasure) — they need ls -a to see it!Gran revelación: El tesoro es un archivo oculto (.treasure) — ¡necesitan ls -a para verlo!
Don't give away the hidden file trick right away — let them struggle for 1–2 minutesNo revelés el truco del archivo oculto de una vez — dejá que luchen 1–2 minutos
If a group is stuck after 2 minutes, hint: "Have you tried seeing ALL the files?"Si un grupo está atascado después de 2 minutos, pista: "¿Intentaron ver TODOS los archivos?"
There's also a hidden bonus: .secret-star in the forestTambién hay un bonus oculto: .secret-star en el bosque

🤖 Robot Factory🤖 Fábrica de Robots 8 min

Goal:Meta: Create files, rename them, count themCrear archivos, renombrarlos, contarlos

Key commands:Comandos clave: touch, ls, mv, wc -l

Students get creative with robot part names — encourage it!Los estudiantes se ponen creativos con los nombres de piezas — ¡animalo!
Challenge fast groups: "Can you build a robot with 15 parts?"Retá a los grupos rápidos: "¿Podés construir un robot con 15 piezas?"
Remind them: blue = folders, white = filesRecordales: azul = carpetas, blanco = archivos

🎮 Terminal Playground🎮 Zona de Juegos 5 min

Goal:Meta: Have FUN — see the terminal can be playfulDIVERTIRSE — ver que la terminal puede ser divertida

Requires:Requiere: cowsay, figlet, sl, cmatrix (fromde setup-fun.sh)

If tools aren't installed, students can still try echo, cal, date, whoamiSi las herramientas no están instaladas, los estudiantes pueden probar echo, cal, date, whoami
figlet is a huge hit — kids love seeing their name in giant letters! Try figlet [STUDENT NAME]figlet es un éxito — ¡a los chicos les encanta ver su nombre en letras gigantes! Probá figlet [NOMBRE]
cmatrix is a crowd favorite — let them enjoy it! Press q to quitcmatrix es el favorito — ¡dejalos disfrutarlo! Presioná q para salir
echo "I love tacos" | cowsay always gets laughsecho "Me encantan los tacos" | cowsay siempre saca risas

📝 First Script📝 Primer Script 7 min

Goal:Meta: Write and run a bash script in nanoEscribir y ejecutar un script de bash en nano

Key moment: When they run their script and it WORKS — celebrate it!Momento clave: Cuando ejecutan su script y FUNCIONA — ¡celebralo!
Walk them through nano: type → Ctrl+O to save → Enter → Ctrl+X to exitGuialos por nano: escribir → Ctrl+O para guardar → Enter → Ctrl+X para salir
Emphasize: "You just wrote a PROGRAM. You are now a programmer."Enfatizá: "Acabás de escribir un PROGRAMA. Ahora sos programador."
This is the most common place students need help — circulate activelyEste es el lugar más común donde los estudiantes necesitan ayuda — circulá activamente

🔍 Command Detective🔍 Detective de Comandos Bonus

Goal:Meta: Use grep to solve a mysteryUsar grep para resolver un misterio

Only for groups that finish everything earlySolo para grupos que terminen todo temprano
Answer: Alex stole the cookie (was in kitchen, likes cookies, had chocolate on shirt)Respuesta: Alex robó la galleta (estaba en la cocina, le gustan las galletas, tenía chocolate en la camisa)
Great for curious/advanced students who want a real challengeIdeal para estudiantes curiosos/avanzados que quieran un reto real

👥 Group & Energy ManagementManejo de Grupos y Energía

🔄 Rotation Rule🔄 Regla de Rotación

Every activity, a different person typesEn cada actividad, una persona diferente escribe
Other group members help by reading instructions and suggesting commandsLos otros miembros del grupo ayudan leyendo instrucciones y sugiriendo comandos
No one should type for more than one activity in a rowNadie debería escribir por más de una actividad seguida

⚡ Energy Management⚡ Manejo de Energía

SituationSituación	What to DoQué Hacer
Energy dropsBaja la energía	Switch to Terminal Playground — fun commands wake everyone upCambiá a Zona de Juegos — los comandos divertidos despiertan a todos
Groups racing aheadGrupos muy adelantados	Give them the Command Detective bonusDales el bonus de Detective de Comandos
Groups falling behindGrupos atrasados	Skip Terminal Playground → go straight to First ScriptSaltá la Zona de Juegos → directo al Primer Script
Noise getting loudMucho ruido	Terminal excitement is GOOD! Only redirect if groups distract each other. Say: "Indoor hacker voices"¡La emoción de la terminal es BUENA! Solo redirigí si los grupos se distraen. Decí: "Voces de hacker en interiores"

🎯 When to Help vs. When to Observe🎯 Cuándo Ayudar vs. Cuándo Observar

SituationSituación	ActionAcción
Student is thinking and trying commandsEl estudiante está pensando y probando comandos	👀 Observe — let them figure it out👀 Observar — dejá que lo descubran
Stuck for 2+ minutesAtascado por 2+ minutos	💬 Hint — don't give the answer, give a direction💬 Pista — no des la respuesta, da una dirección
Typed something wrong, got an errorEscribió algo mal, salió un error	👍 Encourage — "Errors are normal! Read the message."👍 Animar — "¡Los errores son normales! Leé el mensaje."
Accidentally broke somethingRompió algo por accidente	🔧 Help — re-run `setup.sh`🔧 Ayudar — volver a ejecutar `setup.sh`
Excited and wants to exploreEmocionado y quiere explorar	🚀 Encourage — "Try it! See what happens!"🚀 Animar — "¡Probalo! ¡A ver qué pasa!"
Afraid to typeTiene miedo de escribir	💪 Reassure — "You can't break anything. Try it!"💪 Tranquilizar — "No podés romper nada. ¡Probalo!"

🛠️ TroubleshootingSolución de Problemas

ProblemProblema	SolutionSolución
Ubuntu won't openUbuntu no abre	Start menu → search "Ubuntu"Menú Inicio → buscar "Ubuntu"
`"Permission denied"`	Try adding `bash` before the script nameIntentá agregar `bash` antes del nombre del script
`"command not found"` for fun tools`"command not found"` para herramientas divertidas	Run `sudo bash setup-fun.sh` firstEjecutá `sudo bash setup-fun.sh` primero
Student deleted files by accidentEl estudiante borró archivos por accidente	Re-run `bash setup.sh` — it resets everythingEjecutá de nuevo `bash setup.sh` — reinicia todo
nano is confusingnano es confuso	Walk them through: type → `Ctrl+O` → Enter → `Ctrl+X`Guialos: escribir → `Ctrl+O` → Enter → `Ctrl+X`
Terminal looks frozenLa terminal parece congelada	They might be in a program — try `Ctrl+C` or `q`Pueden estar en un programa — probá `Ctrl+C` o `q`
`"No such file or directory"`	Check spelling, use `ls` to see what's availableRevisá la ortografía, usá `ls` para ver qué hay disponible
WSL not installed on a laptopWSL no está instalado en una laptop	Open PowerShell as Admin: `wsl --install -d Ubuntu`Abrí PowerShell como Admin: `wsl --install -d Ubuntu`

⚠️ Quick Reset: If anything goes wrong on a student's laptop, one command fixes it: ⚠️ Reinicio Rápido: Si algo sale mal en la laptop de un estudiante, un comando lo arregla:

curl -sL https://linux.brenes.info/setup.sh | bash

This re-creates all folders and files from scratch. Students can continue where they left off. Esto re-crea todas las carpetas y archivos desde cero. Los estudiantes pueden continuar donde se quedaron.

🏁 Wrap-Up ScriptGuión de Cierre 1 minuteminuto

"You just navigated a Linux terminal, created files, searched through evidence, and WROTE YOUR OWN PROGRAM. That's what builders do. Linux runs the world — and now you know how to use it. Keep exploring. Keep building. 🐧" "Acabás de navegar una terminal Linux, creaste archivos, buscaste evidencia y ESCRIBISTE TU PROPIO PROGRAMA. Eso es lo que hacen los constructores. Linux mueve el mundo — y ahora sabés cómo usarlo. Seguí explorando. Seguí construyendo. 🐧"

Linux is not just used.
Linux is controlled.
Linux is built with. Linux no solo se usa.
Linux se controla.
Con Linux se construye.

Quick-reference links:Enlaces de referencia rápida:

Workshop Website | GitHub Repository | linux.brenes.info

Linux Adventure Workshop • Instructor GuideGuía del Instructor • WSL Ubuntu

Linux Adventure WorkshopTaller de Aventura Linux

⏱️ Timeline⏱️ Cronograma

🐧 All-in-One Installer — install-workshop.ps1🐧 Instalador Todo-en-Uno — install-workshop.ps1

✅ Pre-Flight Checklist✅ Lista de Verificación

🖥️ Welcome Slides🖥️ Diapositivas de Bienvenida

🗺️ Treasure Hunt🗺️ Búsqueda del Tesoro 8 min

🤖 Robot Factory🤖 Fábrica de Robots 8 min

🎮 Terminal Playground🎮 Zona de Juegos 5 min

📝 First Script📝 Primer Script 7 min

🔍 Command Detective🔍 Detective de Comandos Bonus

🔄 Rotation Rule🔄 Regla de Rotación

⚡ Energy Management⚡ Manejo de Energía

🎯 When to Help vs. When to Observe🎯 Cuándo Ayudar vs. Cuándo Observar

🐧 All-in-One Installer — `install-workshop.ps1`🐧 Instalador Todo-en-Uno — `install-workshop.ps1`