Level Up Your Python Skills
While Building Games!

I'm GUIDERA, your agentic AI companion PLUGIN designed to guide you — let's develop it right and build real games together!

Learn by doing. Build by playing. Code like a pro.

BDD Methodology Python 3.12 MIT License

Explore Our Community

When you join GUIDERA, you become part of a learning community

🎮

Build Together

Create text-based games alongside other Python learners at your level

💬

Share and Get Feedback

Show your projects, get tips, and learn from what others are building

📚

Learn Professional Practices

Master SBE, EDD, BDD, and TDD: the same methods used by professional developers

🏆

Access Sample Projects

Learn from completed games in our samples repository for inspiration

The Secret Sauce

Learn professional development methodologies while having fun

🔍

SBE

Specification By Example

Real examples capture true intent. You build what users actually want.

🎯

EDD

Example-Driven Development

Specific scenarios guide design decisions. Edge cases surface early.

📋

BDD

Behavior-Driven Development

Given-When-Then scenarios as specs. Everyone speaks the same language.

✅

TDD

Test-Driven Development

Red-Green-Refactor cycle. Code that works, guaranteed.

Choose Your Game

Pick a game to build and start learning Python concepts

🏰

DungeonCrawler

Explore dungeons, fight monsters, collect treasure!

Learn: Dictionaries, map systems, random encounters

Inspired by: Zork, Colossal Cave Adventure

🕵️

Detective Mystery

Solve crimes by interviewing suspects and finding clues!

Learn: Dialogue trees, JSON data, branching endings

Inspired by: Sherlock Holmes: Consulting Detective

🏝️

HorrorSurvival

Stranded on an island: survive by managing resources!

Learn: Game loops, state management, crafting systems

Inspired by: The Oregon Trail

🚀

SciFiExploration

Travel planets, trade goods, meet alien species!

Learn: Procedural generation, diplomacy, random events

Inspired by: Elite, Star Trader

🔐

PuzzleEscape

Escape locked rooms by solving mind-bending puzzles!

Learn: Function design, state tracking, puzzle logic

Inspired by: The Room

✨

Your Game Idea

Create your own game adventure from scratch!

Learn: Design, planning, creativity, problem-solving

Inspired by: YOUR IMAGINATION

How GUIDERA Works

Switch agents anytime based on what you need

PLAN

Design specs and tests

→

CODE

Implement features

→

ASK

Get help and guidance

→

DEBUG

Fix issues and refactor

What You Will Learn

Master professional skills while building fun games

✓ Python Best Practices: Write clean, maintainable code
✓ Test-Driven Development: Write tests first, code with confidence
✓ Behavior-Driven Design: Think in user stories and scenarios
✓ Project Structure: Organize code like a professional
✓ Conda Environments: Manage dependencies properly
✓ Textual Framework: Build beautiful terminal UIs
✓ Git Workflow: Version control from day one
✓ Debugging Skills: Find and fix bugs systematically

Tech Stack

Industry-standard tools you will master

Python 3.12

Core language

Textual

Terminal UI framework

pytest-bdd

BDD testing framework

Conda

Environment management

Kilo CLI

AI coding assistant

Who Is This For?

🎓 Teenagers who completed beginner Python courses
🔥 Ready to level up to intermediate skills
🎮 Excited to build real games, not just tutorials
💪 Wanting to learn professional practices early

Ready to Join?

The best way to learn is by building. Pick a game and start your journey today!