yellow-olive 0.5.2

A terminal-native retro Kubernetes adventure inspired by Pokemon Yellow.

Project Yellow Olive

Pokémon Yellow, but you tame Kubernetes clusters instead of Pokémon.

A terminal-native retro adventure designed to make infrastructure learning feel fun, nostalgic, and a little less overwhelming.

If Yellow Olive helps you learn or stay motivated, a star on GitHub goes a long way - it helps more people find the project.

📖 Interested in the technicalities - architecture, contributing, troubleshooting, and local development? Find your way here → Technical Documentation

---

Try it

Prerequisites: Python 3.10+, Docker, Minikube, and kubectl.

pip install yellow-olive
yellow-olive start

The first time you begin a mission, the game spins up a local Minikube cluster - this can take up to a minute.

Tip: keep two terminal tabs open - one for the game, one as your Command Chamber for kubectl commands.

Running from source or need setup help? See the documentation.

---

The Motivation

Kubernetes is powerful...
Kubernetes is everywhere...
Kubernetes runs the modern world...
And yet, for many of us, learning it feels confusing, overwhelming, and sometimes just plain boring :(

Project Yellow Olive is my personal, experimental attempt at changing that.

I grew up on a GameBoy, lost in the world of Pokémon. Even today, a single chiptune note takes me straight back to those golden childhood days. I know I'm not alone in that feeling.

Nostalgia has a strange power - it lowers resistance, sparks curiosity, and makes difficult things feel lighter.

Yellow Olive is built on that belief: combine nostalgia with motivation, and even something as complex as Kubernetes can become approachable.

---

An Honest Take

I've attempted the CKAD and CKA certifications - and I didn't clear them.

Not because I didn't understand the concepts, but because I didn't practice enough. Platforms like Killer.sh demand consistency and repetition - and like many of us, I underestimated that discipline.

This project isn't a replacement for serious exam prep.

It's a practice ground - a way to build confidence, stay engaged, and keep the adrenaline slightly elevated while solving real problems.

Not every day is productive. Not every day is high-energy.

This is just my attempt to make the hard days a little easier to push through.

---

Meet the Characters

Professor Bald Uncle

The classic mentor archetype. Calm, experienced, slightly intimidating at first glance.

He steps in when you're stuck, nudges you in the right direction, and reminds you that debugging is part of the journey.

Strict on the outside, generous at heart.

Electromon

Your closest companion. Quiet by nature, but restless at heart - he doesn't like being confined for long.

When something feels off in the cluster, he's usually at the center of it. Shy, but loyal through every broken deployment.

PsyQuack

He doesn't talk much. He watches.
You think you fixed the Deployment? He checks.
You're confident the Service works? He verifies.
If something's still off, PsyQuack will let you know - in his own slightly unhinged way.
He doesn't reward effort. He rewards correctness.

Cool Turtle

A wandering engineer who shows up wherever the cluster needs steady hands.

Calm under pressure, stubborn about uptime, and always trying to keep the signal alive
long enough for someone else to finish the fix.

You'll meet him again - different towns, same problem: something critical stopped reaching
where it was supposed to go.

Team Evil

The recurring troublemakers of the Yellow Olive world.

They rarely smash workloads directly - they break the paths between them: routing, naming,
visibility, the quiet plumbing that makes a cluster feel like one system.

Wherever infrastructure should connect, Team Evil has probably been there first.

---

From Yellow Olive to Kubernetes

Every character, keyword, and challenge maps directly to a real Kubernetes concept.

Yellow Olive Concept	Kubernetes Equivalent	What It Means in Practice
Posemon	Container	A single runnable unit inside a workload
Pokepod	Pod	The smallest deployable unit - houses Posemons
Region / Town	Namespace	A bounded district in the cluster - separate scope for resources

(And many more - every mechanic is built to teach something real.)

---

Gameplay Commands

• psyquack validate - PsyQuack checks your cluster fix for the current challenge.
• psyquack hint - A nudge from Professor Bald (without spoiling the answer).
• psyquack back - Return to the previous screen.

---

See it in Action

Full gameplay walkthrough (2 min): Watch on YouTube

---

Contributing

Contributions are welcome - especially new challenges and scenarios.

Open an issue with your idea, then follow the contributing guide in the documentation.

---

Roadmap

Save/load progress and PyPI packaging are live. The Signal Town arc (Services, DNS, Ingress) is in active development.

Full roadmap → documentation

---

Music Credits

Music is sourced from OpenGameArt. Licenses vary by track - see the table below. Attribution is required for CC-BY tracks.

Music File	Track Name	Author	License
screen_1_opening_song.mp3	JRPG Piano	Joth	CC0
screen_2_music.mp3	Town Theme RPG	Joth	CC0
battle_music.ogg	8 bit RPG Battle Encounter Theme	Ted Kerr	CC0
battle_music_2.mp3	8 bit Chiptune Encounter Theme	Shiru8Bit	CC0
win_music.ogg	Win Jingle	Fupi	CC0
loose_music.ogg	Lost Game Short Music Clip	Robin Lamb	CC0
signal_town_intro_music.mp3	Abandoned	Preston Peak	CC0
cool_turtle_intro_music.mp3	Fated Encounter	Preston Peak	CC0
team_evil_intro_music.mp3	Boneyard	Preston Peak	CC0
gold_rush_city_intro_music.ogg	Dacoit ~ Desert Theme	Spring	CC-BY 3.0
walk_to_vault.ogg	Lasso Lady	congusbongus	CC0

---

License

MIT - see LICENSE for details.