add demo

.dockerignore

@@ -0,0 +1,231 @@
+# Copy from .gitignore - ignore everything that git ignores
+__pycache__/
+*.py[codz]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+# .python-version
+
+# pipenv
+#Pipfile.lock
+
+# UV
+#uv.lock
+
+# poetry
+#poetry.lock
+#poetry.toml
+
+# pdm
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#pixi.lock
+.pixi
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#.idea/
+
+# Abstra
+.abstra/
+
+# Visual Studio Code
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Kiro
+.kiro/
+
+# Data
+data/
+
+# exploratory notebooks
+*.ipynb
+
+# claude
+CLAUDE.md
+.claude/
+
+# Ephemeral DB locks
+crewai-rag-tool.lock
+db/
+chromadb-*.lock
+
+# Docker specific ignores
+# Absolutely ignore ChromaDB stuff
+chromadb/
+*.chromadb
+chroma_db/
+chromadb-*
+*.chroma
+
+# Git files
+.git/
+.gitignore
+README_old.md
+
+# Development files
+tests/
+tests_*/
+examples/
+*.md
+!README.md
+
+# Local development
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# IDE files
+.vscode/
+.idea/
+*.sublime-*
+
+# Docker files (don't copy Docker files into container)
+Dockerfile
+.dockerignore
+docker-compose.yml
+docker-compose.*.yml
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+.travis.yml

.gitattributes

@@ -33,3 +33,7 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+*.gif filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,225 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Kiro
+.kiro/
+
+# Data
+data/
+
+# exploratory notebooks
+*.ipynb
+
+# claude
+CLAUDE.md
+.claude/
+
+# Ephemeral DB locks
+crewai-rag-tool.lock
+db/
+chromadb-*.lock"assets/images/" 

Dockerfile

@@ -0,0 +1,47 @@
+# Use official Python runtime as base image
+FROM python:3.12-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install uv for fast Python package management
+RUN pip install uv
+
+# Copy dependency files
+COPY pyproject.toml uv.lock ./
+
+# Install dependencies only (not the local package)
+RUN uv export --format requirements-txt --no-hashes > requirements.txt && \
+    uv venv && \
+    uv pip install -r requirements.txt
+
+# Copy application code
+COPY src/ ./src/
+COPY web_server.py ./
+COPY korean_mud_game.html ./
+COPY assets/ ./assets/
+
+# Create non-root user for security
+RUN useradd --create-home --shell /bin/bash appuser && \
+    chown -R appuser:appuser /app
+USER appuser
+
+# Expose port for HuggingFace Spaces
+EXPOSE 7860
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:7860/api/game/help || exit 1
+
+# Set environment variables
+ENV PYTHONPATH=/app
+ENV PYTHONUNBUFFERED=1
+ENV DOCKER_ENV=1
+
+# Run the application
+CMD ["uv", "run", "python", "web_server.py"]

README.md

@@ -9,4 +9,146 @@ license: mit
 short_description: Interactive Korean language learning  MUD game
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Korean Learning MUD Game 🇰🇷
+
+Interactive Korean language learning through conversation with AI-powered Korean family members in a retro MUD-style game.
+
+![Korean Family Portrait](assets/images/Family%20portraits%202ChatGPT%20Image%20Aug%2017,%202025,%2010_48_14%20PM.png)
+
+> **Live Demo:** Hosted on HuggingFace Spaces for easy access
+
+## Features
+
+- 🏠 **Explore a Korean Family House** - Navigate through 6 rooms (Hall, Kitchen, Garden, Bedroom, Study, Classroom)
+- 👨‍👩‍👧‍👦 **Chat with Unique NPCs** - Each family member has distinct personalities and teaching styles
+- 🔍 **Examine Cultural Objects** - Interactive objects in each room teach Korean vocabulary and culture
+- 🎨 **Retro Terminal Aesthetic** - Beautiful brown/tan Korean traditional vibes
+- 📚 **Progressive Learning System** - Smart vocabulary tracking with no repeats
+- 💬 **Natural Conversation** - Chat naturally with AI agents powered by CrewAI
+- 🎒 **Inventory System** - Collect examined objects and track learning progress
+
+## Korean Family Members
+
+Meet your Korean language teachers - each AI agent has a unique personality and teaching style powered by CrewAI:
+
+| Family Member             | Korean Name     | Room         | Teaching Focus                    | Avatar                                                                                            |
+| ------------------------- | --------------- | ------------ | --------------------------------- | ------------------------------------------------------------------------------------------------- |
+| **Grandma Kim Soon-ja**   | 김순자 할머니   | 🍳 Kitchen   | Honorifics & Formal Speech        | ![Grandma](assets/images/Ahjumma%20ChatGPT%20Image%20Mar%2026,%202025,%2005_36_15%20PM.png)       |
+| **Grandpa Park Chul-min** | 박철민 할아버지 | 🌸 Garden    | Traditional Culture & Proverbs    | ![Grandpa](assets/images/Ahjussi%20ChatGPT%20Image%20May%205,%202025,%2004_37_07%20PM.png)        |
+| **Sister Lee Min-ji**     | 이민지 언니     | 🎵 Bedroom   | K-pop & Modern Slang              | ![Sister](assets/images/K-pop%20trainee%20ChatGPT%20Image%20May%205,%202025,%2004_35_54%20PM.png) |
+| **Brother Jung Jae-hyun** | 정재현 오빠     | 📚 Study     | Grammar & Academic Korean         | ![Brother](assets/images/SunbaeOppa%20ChatGPT%20Image%20May%205,%202025,%2004_07_13%20PM.png)     |
+| **Teacher Choi Soo-jin**  | 최수진 선생님   | ✏️ Classroom | Practical Phrases & Communication | ![Teacher](assets/images/SeonsaengnimChatGPT%20Image%20Aug%2017,%202025,%2010_41_39%20PM.png)     |
+
+## How to Play
+
+### Basic Commands
+
+- `look` - Look around your current room
+- `go [room]` - Move to another room (kitchen, garden, bedroom, study, classroom, hall)
+- `examine [object]` - Examine objects to learn Korean vocabulary
+- `chat [message]` - Talk to the Korean family member in your room
+- `help` - Show all available commands
+- `map` - See the house layout and room locations
+
+### Game Flow
+
+1. **Start in the Hall** - Central hub connecting all rooms
+2. **Visit Family Members** - Each room has a different Korean family member
+3. **Examine Objects** - Learn vocabulary and cultural context
+4. **Practice Conversations** - Natural Korean language practice
+5. **Track Progress** - See words learned and objects examined
+
+## Screenshots
+
+![Game Running](assets/images/app-running.png)
+_Main game interface with retro terminal styling_
+
+![Chat with Grandmother](assets/images/chat-grandmother.png)
+_Learning proper Korean honorifics with Grandma in the Kitchen_
+
+![Chat with Grandfather](assets/images/chat-grandfather.png)
+_Traditional Korean wisdom and proverbs in the Garden_
+
+![Vocabulary & Inventory Tracking](assets/images/chat-words+inventory.png)
+_Track your Korean learning progress and cultural discoveries_
+
+## Quick Start
+
+### Option 1: Docker (Recommended)
+
+1. **Clone and navigate to project:**
+
+   ```bash
+   git clone https://github.com/Ramsi-K/korean-cpc-agents
+   cd korean-cpc-agents
+   ```
+
+2. **Set up environment:**
+
+   ```bash
+   # Create .env file with your OpenAI API key
+   echo "OPENAI_API_KEY=your-api-key-here" > .env
+   ```
+
+3. **Run with Docker Compose:**
+
+   ```bash
+   docker compose up --build
+   ```
+
+4. **Play the game:**
+   Open http://localhost:7860 in your browser!
+
+### Option 2: Local Development
+
+1. **Install dependencies:**
+
+   ```bash
+   uv sync
+   ```
+
+2. **Set up your OpenAI API key:**
+
+   ```bash
+   export OPENAI_API_KEY="your-api-key-here"
+   ```
+
+3. **Run the game:**
+
+   ```bash
+   uv run python web_server.py
+   ```
+
+4. **Open your browser:**
+
+   ```bash
+   http://localhost:7860
+   ```
+
+## Technology Stack
+
+- **Backend:** FastAPI + Python
+- **AI Agents:** CrewAI with OpenAI GPT models
+- **Frontend:** Vanilla HTML/CSS/JavaScript with retro terminal styling
+- **Package Management:** uv
+- **Game Engine:** Custom MUD-style text adventure system
+
+## Project Structure
+
+```yaml
+korean-cpc-agents/
+├── src/korean_cpc_agents/    # Core game logic and AI agents
+├── korean_mud_game.html      # Frontend interface
+├── web_server.py            # FastAPI backend server
+├── assets/images/           # Game images and sprites
+└── examples/               # Screenshots and demos
+```
+
+## License
+
+Open source - feel free to fork and create your own language learning MUD games!
+
+---
+
+*Learn Korean through immersive conversations with AI-powered family members! 한국어를 배워보세요! 🇰🇷*🫰
+[With Love](assets/images/Ahjumma%20and%20Ahjussi.png)

docker-compose.yml

@@ -0,0 +1,26 @@
+services:
+  korean-mud-game:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - '7860:7860'
+    environment:
+      - OPENAI_API_KEY=${OPENAI_API_KEY}
+      - PYTHONUNBUFFERED=1
+      - DOCKER_ENV=1
+    restart: unless-stopped
+    healthcheck:
+      test: ['CMD', 'curl', '-f', 'http://localhost:7860/api/game/help']
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    volumes:
+      - ./assets:/app/assets:ro
+    networks:
+      - korean-mud-network
+
+networks:
+  korean-mud-network:
+    driver: bridge

korean_mud_game.html

@@ -0,0 +1,1219 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>🏠 한국어 가족집 모험 🇰🇷</title>
+    <style>
+        @import url('https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@400;500;700&family=Orbitron:wght@400;700&display=swap');
+        
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        
+        body {
+            font-family: 'Courier New', monospace;
+            background: url('assets/images/bukchon-hanok-thumb-scaled.jpg') center/cover fixed;
+            background-color: #f5e9d9;
+            color: #3a3226;
+            min-height: 100vh;
+            overflow-x: hidden;
+            position: relative;
+        }
+        
+        body::before {
+            content: '';
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            bottom: 0;
+            background: url('assets/images/repeat-background.jpg') repeat;
+            opacity: 0.15;
+            pointer-events: none;
+            z-index: -1;
+        }
+        
+        /* Animated background elements */
+        .bg-particles {
+            position: fixed;
+            width: 100%;
+            height: 100%;
+            pointer-events: none;
+            z-index: -1;
+            overflow: hidden;
+        }
+        
+        .particle {
+            position: absolute;
+            width: 2px;
+            height: 2px;
+            background: rgba(255, 255, 255, 0.3);
+            animation: float 6s ease-in-out infinite;
+        }
+        
+        .flower-petal {
+            position: absolute;
+            width: 15px;
+            height: 15px;
+            background-image: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="%23ff9ff3" d="M12,2C13.1,2 14,2.9 14,4C14,5.1 13.1,6 12,6C10.9,6 10,5.1 10,4C10,2.9 10.9,2 12,2M15.5,8C16.3,8 17,8.7 17,9.5C17,10.3 16.3,11 15.5,11C14.7,11 14,10.3 14,9.5C14,8.7 14.7,8 15.5,8M8.5,8C9.3,8 10,8.7 10,9.5C10,10.3 9.3,11 8.5,11C7.7,11 7,10.3 7,9.5C7,8.7 7.7,8 8.5,8M12,11C13.1,11 14,11.9 14,13C14,14.1 13.1,15 12,15C10.9,15 10,14.1 10,13C10,11.9 10.9,11 12,11M19,17V19H5V17C5,14.8 8.1,13 12,13C15.9,13 19,14.8 19,17Z" /></svg>');
+            background-size: contain;
+            opacity: 0.7;
+            animation: petalFall linear infinite;
+        }
+        
+        @keyframes float {
+            0%, 100% { transform: translateY(0px) rotate(0deg); opacity: 0.3; }
+            50% { transform: translateY(-20px) rotate(180deg); opacity: 0.8; }
+        }
+        
+        @keyframes petalFall {
+            0% {
+                transform: translate(0, -10vh) rotate(0deg);
+                opacity: 0;
+            }
+            10% {
+                opacity: 0.7;
+            }
+            90% {
+                opacity: 0.7;
+            }
+            100% {
+                transform: translate(var(--random-x), 100vh) rotate(360deg);
+                opacity: 0;
+            }
+        }
+        
+        /* Header */
+        .game-header {
+            background: linear-gradient(90deg, #8b6b4a, #6b4f32, #8b6b4a);
+            padding: 10px 0;
+            text-align: center;
+            border-bottom: 3px solid #3a3226;
+        }
+        
+        .header-content h1 {
+            font-family: 'Gungsuh', 'Batang', serif;
+            font-size: 2.5em;
+            font-weight: 700;
+            color: #3a3226;
+            margin-bottom: 5px;
+            text-shadow: 2px 2px 4px rgba(0,0,0,0.1);
+            letter-spacing: 1px;
+        }
+
+        .progress-stats {
+            display: flex;
+            gap: 15px;
+            justify-content: center;
+            margin-top: 10px;
+            flex-wrap: wrap;
+        }
+        
+        .progress-indicator {
+            background: rgba(107, 79, 50, 0.7);
+            border: 2px solid #3a3226;
+            border-radius: 20px;
+            padding: 5px 15px;
+            display: inline-flex;
+            align-items: center;
+            gap: 10px;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+
+        .progress-indicator:hover {
+            background: rgba(107, 79, 50, 0.9);
+            box-shadow: 0 0 10px rgba(107, 79, 50, 0.5);
+        }
+
+        .progress-count {
+            font-family: 'Courier New', monospace;
+            font-weight: bold;
+            color: #f5e9d9;
+            font-size: 1.2em;
+        }
+
+        .progress-label {
+            font-size: 0.9em;
+            color: #f5e9d9;
+        }
+        
+        .header-content p {
+            color: rgba(255,255,255,0.9);
+            font-size: 1.1em;
+        }
+        
+        /* Main game container */
+        .game-container {
+            display: grid;
+            grid-template-columns: 1fr 300px;
+            gap: 20px;
+            padding: 20px;
+            max-width: 1400px;
+            margin: 0 auto;
+            min-height: calc(100vh - 120px);
+        }
+        
+        /* Chat area */
+        .chat-section {
+            background: rgba(245, 233, 217, 0.85);
+            border: 2px solid #8b6b4a;
+            border-radius: 0;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.2), 
+                        inset 0 0 30px rgba(139, 107, 74, 0.3);
+            display: flex;
+            flex-direction: column;
+            overflow: hidden;
+            max-width: 800px;
+            margin: 0 auto;
+            position: relative;
+        }
+        
+        .chat-section::before {
+            content: '';
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            bottom: 0;
+            background: url('assets/images/repeat-background.jpg') repeat;
+            opacity: 0.05;
+            pointer-events: none;
+            z-index: 0;
+        }
+        
+        .chat-header {
+            background: linear-gradient(90deg, #8b6b4a, #6b4f32, #8b6b4a);
+            padding: 15px 20px;
+            color: #f5e9d9;
+            font-weight: 600;
+            border-bottom: 2px solid #3a3226;
+        }
+        
+        .current-npc-info {
+            display: flex;
+            align-items: center;
+            gap: 15px;
+        }
+        
+        .npc-avatar {
+            width: 50px;
+            height: 50px;
+            border-radius: 50%;
+            border: 3px solid white;
+            object-fit: cover;
+        }
+        
+        .npc-details h3 {
+            font-size: 1.2em;
+            margin-bottom: 2px;
+        }
+        
+        .npc-details p {
+            font-size: 0.9em;
+            opacity: 0.9;
+        }
+        
+        #game-messages {
+            flex: 1;
+            padding: 20px;
+            overflow-y: auto;
+            max-height: 400px;
+            scrollbar-width: thin;
+            scrollbar-color: #4a5568 #2d3748;
+        }
+        
+        #game-messages::-webkit-scrollbar {
+            width: 8px;
+        }
+        
+        #game-messages::-webkit-scrollbar-track {
+            background: #2d3748;
+            border-radius: 4px;
+        }
+        
+        #game-messages::-webkit-scrollbar-thumb {
+            background: #4a5568;
+            border-radius: 4px;
+        }
+        
+        /* Message styling */
+        .game-text {
+            margin-bottom: 12px;
+            padding: 8px 12px;
+            line-height: 1.5;
+            border-left: 3px solid transparent;
+            opacity: 0;
+            animation: fadeIn 0.3s forwards;
+        }
+        
+        @keyframes fadeIn {
+            to { opacity: 1; }
+        }
+        
+        .npc-dialogue {
+            background: rgba(255,255,255,0.7);
+            color: #3a3226;
+            border-left: 3px solid #8b6b4a;
+            padding: 12px 16px;
+            margin: 10px 0;
+            position: relative;
+            transform: translateX(-20px);
+            animation: slideIn 0.5s forwards;
+        }
+        
+        @keyframes slideIn {
+            to { transform: translateX(0); }
+        }
+        
+        .npc-name {
+            color: #a52a2a;
+            font-weight: bold;
+        }
+        
+        .command-echo {
+            background: rgba(255,255,255,0.3);
+            color: #3a3226;
+            font-style: italic;
+            border-radius: 15px 15px 5px 15px;
+            padding: 8px 12px;
+            text-align: right;
+            font-weight: 600;
+        }
+        
+        .help-content {
+            background: rgba(245, 233, 217, 0.9);
+            border: 2px solid #8b6b4a;
+            border-radius: 0;
+            padding: 15px;
+            white-space: pre-line;
+            font-family: 'Courier New', monospace;
+            font-size: 0.9em;
+            color: #3a3226;
+            margin: 10px 0;
+            box-shadow: inset 0 0 10px rgba(139, 107, 74, 0.3);
+        }
+        
+        .korean-text {
+            font-size: 1.1em;
+            line-height: 1.6;
+        }
+        
+        .vocab-highlight {
+            background: linear-gradient(45deg, #ff6b6b, #feca57);
+            color: white;
+            padding: 2px 6px;
+            border-radius: 4px;
+            font-weight: 600;
+        }
+        
+        /* Chat input */
+        .chat-input {
+            background: rgba(45, 55, 72, 0.9);
+            padding: 15px 20px;
+            border-top: 1px solid rgba(255,255,255,0.1);
+        }
+        
+        .input-group {
+            display: flex;
+            gap: 10px;
+        }
+        
+        .chat-input input {
+            flex: 1;
+            background: rgba(255,255,255,0.7);
+            border: 2px solid #8b6b4a;
+            border-radius: 0;
+            padding: 12px 20px;
+            color: #3a3226;
+            font-family: 'Courier New', monospace;
+            font-size: 1em;
+            transition: all 0.3s ease;
+            box-shadow: inset 0 0 10px rgba(139, 107, 74, 0.3);
+        }
+        
+        .chat-input input:focus {
+            outline: none;
+            border-color: #3a3226;
+            box-shadow: inset 0 0 15px rgba(139, 107, 74, 0.5);
+            animation: caretBlink 1s step-end infinite;
+        }
+        
+        @keyframes caretBlink {
+            50% { border-right: 2px solid #3a3226; }
+        }
+        
+        .chat-input input::placeholder {
+            color: rgba(255,255,255,0.6);
+        }
+        
+        .send-button {
+            background: linear-gradient(45deg, #8b6b4a, #6b4f32);
+            border: 2px outset #3a3226;
+            border-radius: 0;
+            padding: 12px 24px;
+            color: #f5e9d9;
+            font-family: 'Courier New', monospace;
+            font-weight: 600;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            box-shadow: 3px 3px 0 rgba(0,0,0,0.2);
+            text-shadow: none;
+        }
+        
+        .send-button:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 6px 20px rgba(102, 126, 234, 0.6);
+        }
+        
+        .send-button:disabled {
+            opacity: 0.6;
+            cursor: not-allowed;
+            transform: none;
+        }
+        
+        /* Sidebar */
+        .game-sidebar {
+            display: flex;
+            flex-direction: column;
+            gap: 20px;
+        }
+        
+        .panel {
+            background: rgba(15, 20, 25, 0.8);
+            backdrop-filter: blur(10px);
+            border-radius: 15px;
+            border: 1px solid rgba(255,255,255,0.1);
+            overflow: hidden;
+            box-shadow: 0 8px 32px rgba(0,0,0,0.3);
+        }
+        
+        .panel-header {
+            background: linear-gradient(90deg, #8b6b4a, #6b4f32, #8b6b4a);
+            padding: 12px 16px;
+            font-weight: 600;
+            color: #f5e9d9;
+            border-bottom: 2px solid #3a3226;
+        }
+        
+        .panel-content {
+            padding: 16px;
+        }
+        
+        /* House map */
+        .house-map {
+            font-family: 'Courier New', monospace;
+            font-size: 0.8em;
+            line-height: 1.3;
+            text-align: center;
+            white-space: pre-line;
+            color: #a0aec0;
+        }
+        
+        .current-room-highlight {
+            background: linear-gradient(45deg, #4ecdc4, #44a08d);
+            color: white;
+            padding: 2px 6px;
+            border-radius: 4px;
+            font-weight: bold;
+        }
+        
+        /* Progress stats */
+        .stats {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 10px;
+            margin-bottom: 15px;
+        }
+        
+        .stat-item {
+            background: rgba(255,255,255,0.05);
+            padding: 12px;
+            border-radius: 8px;
+            text-align: center;
+            border: 1px solid rgba(255,255,255,0.1);
+        }
+        
+        .stat-value {
+            font-size: 1.4em;
+            font-weight: 700;
+            color: #4ecdc4;
+            display: block;
+        }
+        
+        .stat-label {
+            font-size: 0.8em;
+            color: #a0aec0;
+            margin-top: 2px;
+        }
+        
+        /* Quick actions */
+        .quick-actions-container {
+            display: flex;
+            justify-content: center;
+            gap: 10px;
+            padding: 10px;
+            background: rgba(107, 79, 50, 0.7);
+            border-top: 2px solid #3a3226;
+            border-bottom: 2px solid #3a3226;
+        }
+
+        .quick-actions-container .quick-btn {
+            flex: 1;
+            max-width: 120px;
+            padding: 8px 5px;
+            font-size: 0.9em;
+            font-family: 'Courier New', monospace;
+            border-radius: 0;
+            background: rgba(245, 233, 217, 0.9);
+            color: #3a3226;
+            border: 2px outset #8b6b4a;
+            font-weight: bold;
+            text-shadow: none;
+            box-shadow: none;
+        }
+
+        .quick-actions-container .quick-btn:hover {
+            background: rgba(245, 233, 217, 0.95);
+            animation: neonFlicker 0.5s infinite alternate;
+        }
+        
+        .quick-btn {
+            background: #6b4f32;
+            border: 2px outset #8b6b4a;
+            border-radius: 0;
+            padding: 8px 12px;
+            color: #8e6f46;
+            font-family: 'Courier New', monospace;
+            font-size: 0.85em;
+            cursor: pointer;
+            position: relative;
+            text-shadow: 1px 1px 0 #3a3226;
+            box-shadow: 3px 3px 0 rgba(0,0,0,0.2);
+        }
+        
+        .quick-btn:hover {
+            background: #8b6b4a;
+            box-shadow: 0 0 10px rgba(107, 79, 50, 0.7);
+            animation: neonFlicker 0.5s infinite alternate;
+        }
+        
+        @keyframes neonFlicker {
+            0%, 19%, 21%, 23%, 25%, 54%, 56%, 100% {
+                box-shadow: 0 0 10px rgba(107, 79, 50, 0.7);
+            }
+            20%, 24%, 55% {
+                box-shadow: 0 0 15px rgba(107, 79, 50, 0.9);
+            }
+        }
+        
+        /* Room navigation */
+        .room-nav {
+            display: grid;
+            grid-template-columns: 1fr;
+            gap: 6px;
+        }
+        
+        
+        .room-btn {
+            background: rgba(245, 233, 217, 0.2);
+            border: 2px solid #8b6b4a;
+            border-radius: 0;
+            padding: 8px 12px;
+            color: #ecebea;
+            font-size: 0.85em;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            text-align: left;
+            margin-bottom: 5px;
+        }
+        
+        .room-btn:hover {
+            background: rgba(139, 107, 74, 0.3);
+            border-color: #3a3226;
+            color: #3a3226;
+        }
+        
+        .room-btn.current {
+            background: linear-gradient(90deg, #8b6b4a, #6b4f32);
+            border-color: #3a3226;
+            color: #f5e9d9;
+            font-weight: 600;
+        }
+        
+        /* Loading indicator */
+        .loading {
+            color: #8b6b4a;
+            animation: pulse 1.5s ease-in-out infinite;
+            font-weight: 600;
+        }
+        
+        @keyframes pulse {
+            0%, 100% { opacity: 1; }
+            50% { opacity: 0.5; }
+        }
+        
+        /* Success/Error messages */
+        .success { color: #6b4f32; font-weight: 600; }
+        .error { color: #a52a2a; font-weight: 600; background: rgba(165, 42, 42, 0.1); padding: 8px 12px; border-radius: 5px; }
+        
+        /* Responsive design */
+        @media (max-width: 768px) {
+            .game-container {
+                grid-template-columns: 1fr;
+                padding: 10px;
+            }
+            
+            .header-content h1 {
+                font-size: 1.8em;
+            }
+            
+            .quick-actions {
+                grid-template-columns: 1fr;
+            }
+            
+            .stats {
+                grid-template-columns: 1fr;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="bg-particles" id="particles"></div>
+    
+    <header class="game-header">
+        <div class="header-content">
+            <h1>🏠 한국어 가족집 모험</h1>
+            <p>Korean Family House Adventure - Learn Korean through immersive conversations!</p>
+            <div class="progress-stats">
+                <div class="progress-indicator" onclick="showVocabulary()">
+                    <span class="progress-count" id="word-count">0</span>
+                    <span class="progress-label">Korean Words Learned</span>
+                </div>
+                <div class="progress-indicator" onclick="showInventory()">
+                    <span class="progress-count" id="inventory-count">0</span>
+                    <span class="progress-label">Objects Examined</span>
+                </div>
+            </div>
+        </div>
+    </header>
+    
+    <div class="game-container">
+        <div class="chat-section">
+            <div class="chat-header">
+                <div class="current-npc-info">
+                    <img src="assets/images/Family portraits 2ChatGPT Image Aug 17, 2025, 10_48_14 PM.png" alt="NPC Avatar" class="npc-avatar" id="npc-avatar">
+                    <div class="npc-details">
+                        <h3 id="current-npc-name">Loading...</h3>
+                        <p id="current-room-name">Getting ready...</p>
+                    </div>
+                </div>
+            </div>
+            
+            <div id="game-messages">
+                <div class="game-text loading">🎮 Starting your Korean adventure...</div>
+            </div>
+            
+            <!-- Quick Actions moved here under chat -->
+            <div class="quick-actions-container">
+                <button class="quick-btn" onclick="sendQuickCommand('look')">👀 Look</button>
+                <button class="quick-btn" onclick="sendQuickCommand('help')">❓ Help</button>
+                <button class="quick-btn" onclick="showMapDialog()">🗺️ Map</button>
+                <button class="quick-btn" onclick="showExamineDialog()">🔍 Examine</button>
+                <button class="quick-btn" onclick="showChatDialog()">💬 Chat</button>
+            </div>
+            
+            <div class="chat-input">
+                <div class="input-group">
+                    <input type="text" id="command-input" placeholder="Type commands: help, look, examine [object], go [room], chat [message]..." autofocus>
+                    <button class="send-button" id="submit-button">Send 💬</button>
+                </div>
+            </div>
+        </div>
+        
+        <div class="game-sidebar">
+            
+            <!-- Quick Actions removed from sidebar - now under chat -->
+            
+            <!-- House map removed from sidebar -->
+            
+            <div class="panel">
+                <div class="panel-header">
+                    🚀 Quick Navigate
+                </div>
+                <div class="panel-content">
+                    <div class="room-nav">
+                        <button class="room-btn current" onclick="sendQuickCommand('go hall')">🏠 Hall (Central Hub)</button>
+                        <button class="room-btn" onclick="sendQuickCommand('go kitchen')">🍳 Kitchen (Grandma)</button>
+                        <button class="room-btn" onclick="sendQuickCommand('go garden')">🌸 Garden (Grandpa)</button>
+                        <button class="room-btn" onclick="sendQuickCommand('go bedroom')">🎵 Bedroom (Sister)</button>
+                        <button class="room-btn" onclick="sendQuickCommand('go study')">📚 Study (Brother)</button>
+                        <button class="room-btn" onclick="sendQuickCommand('go classroom')">✏️ Classroom (Teacher)</button>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+    
+    <script>
+        // Create animated background elements
+        function createParticles() {
+            const container = document.getElementById('particles');
+            
+            // Create regular particles
+            for (let i = 0; i < 30; i++) {
+                const particle = document.createElement('div');
+                particle.className = 'particle';
+                particle.style.left = Math.random() * 100 + '%';
+                particle.style.top = Math.random() * 100 + '%';
+                particle.style.animationDelay = Math.random() * 6 + 's';
+                container.appendChild(particle);
+            }
+            
+            // Create flower petals
+            for (let i = 0; i < 15; i++) {
+                const petal = document.createElement('div');
+                petal.className = 'flower-petal';
+                petal.style.left = Math.random() * 100 + '%';
+                petal.style.setProperty('--random-x', (Math.random() * 100 - 50) + 'px');
+                petal.style.animationDuration = (8 + Math.random() * 10) + 's';
+                petal.style.animationDelay = Math.random() * 5 + 's';
+                petal.style.width = (10 + Math.random() * 10) + 'px';
+                petal.style.height = petal.style.width;
+                container.appendChild(petal);
+            }
+        }
+        
+        // API base URL
+        const API_BASE = '';
+        
+        // DOM elements
+        const gameMessages = document.getElementById('game-messages');
+        const commandInput = document.getElementById('command-input');
+        const submitButton = document.getElementById('submit-button');
+        const currentNpcName = document.getElementById('current-npc-name');
+        const currentRoomName = document.getElementById('current-room-name');
+        const wordCountSpan = document.getElementById('word-count');
+        const npcAvatar = document.getElementById('npc-avatar');
+        
+        // Check if required elements exist
+        if (!gameMessages || !commandInput || !submitButton || !wordCountSpan) {
+            console.error('Required DOM elements not found!');
+        }
+        
+        // Game state
+        let gameState = {
+            current_room: '',
+            discovered_words: [],
+            isLoading: false,
+            conversationCount: 0
+        };
+        
+        // Room and NPC mapping
+        const roomNames = {
+            'hall': 'Hall (대청)',
+            'kitchen': 'Kitchen (부엌)',
+            'garden': 'Garden (정원)', 
+            'bedroom': 'Bedroom (침실)',
+            'study': 'Study (서재)',
+            'classroom': 'Classroom (교실)'
+        };
+        
+        const npcNames = {
+            'ahjumma_gpt': 'Grandma Kim Soon-ja (김순자 할머니)',
+            'ahjussi_gpt': 'Grandpa Park Chul-min (박철민 할아버지)',
+            'unni_gpt': 'Sister Lee Min-ji (이민지 언니)',
+            'oppa_gpt': 'Brother Jung Jae-hyun (정재현 오빠)',
+            'seonsaengnim_gpt': 'Teacher Choi Soo-jin (최수진 선생님)'
+        };
+        
+        const npcImages = {
+            'ahjumma_gpt': 'assets/images/Ahjumma ChatGPT Image Mar 26, 2025, 05_36_15 PM.png',
+            'ahjussi_gpt': 'assets/images/Ahjussi ChatGPT Image May 5, 2025, 04_37_07 PM.png',
+            'unni_gpt': 'assets/images/K-pop trainee ChatGPT Image May 5, 2025, 04_35_54 PM.png',
+            'oppa_gpt': 'assets/images/SunbaeOppa ChatGPT Image May 5, 2025, 04_07_13 PM.png',
+            'seonsaengnim_gpt': 'assets/images/SeonsaengnimChatGPT Image Aug 17, 2025, 10_41_39 PM.png'
+        };
+        
+        // Initialize game
+        async function initGame() {
+            try {
+                createParticles();
+                addToGame('🎮 Welcome to the Korean Family House Adventure!', 'success korean-text');
+                addToGame('🏠 You\'re about to meet a wonderful Korean family who will teach you their language and culture.', 'game-text');
+                addToGame('');
+                
+                await loadGameState();
+                await loadRoomInfo();
+                
+            } catch (error) {
+                addToGame(`❌ Failed to start game: ${error.message}`, 'error');
+                console.error('Game initialization failed:', error);
+            }
+        }
+        
+        // Load current game state
+        async function loadGameState() {
+            try {
+                const response = await fetch(`${API_BASE}/api/game/state`);
+                if (response.ok) {
+                    gameState = await response.json();
+                    updateUI();
+                }
+            } catch (error) {
+                console.error('Failed to load game state:', error);
+            }
+        }
+        
+        // Load room information
+        async function loadRoomInfo() {
+            try {
+                const response = await fetch(`${API_BASE}/api/game/room-info`);
+                const data = await response.json();
+                
+                if (data.success) {
+                    addToGame(data.message, 'game-text korean-text');
+                    
+                    if (data.data.npc_info && data.data.npc_info.name) {
+                        updateNpcDisplay(data.data);
+                    }
+                    
+                    updateGameState(data.data);
+                } else {
+                    addToGame(`❌ ${data.message}`, 'error');
+                }
+            } catch (error) {
+                addToGame(`❌ Failed to load room info: ${error.message}`, 'error');
+            }
+        }
+        
+        // Update NPC display
+        function updateNpcDisplay(data) {
+            try {
+                if (data.current_room && data.room_mapping) {
+                    const agentName = data.room_mapping[data.current_room];
+                    if (agentName && npcNames[agentName]) {
+                        if (currentNpcName) {
+                            currentNpcName.textContent = npcNames[agentName];
+                        }
+                        if (currentRoomName) {
+                            currentRoomName.textContent = roomNames[data.current_room] || data.current_room;
+                        }
+                        
+                        // Update avatar
+                        if (npcAvatar && npcImages[agentName]) {
+                            npcAvatar.src = npcImages[agentName];
+                            npcAvatar.alt = npcNames[agentName];
+                        }
+                    }
+                }
+            } catch (error) {
+                console.error('Error updating NPC display:', error);
+            }
+        }
+        
+        // Update UI with game state
+        function updateUI() {
+            // Update word count in header
+            if (wordCountSpan) {
+                wordCountSpan.textContent = gameState.discovered_words.length;
+            }
+            
+            // Update inventory count in header
+            const inventoryCountSpan = document.getElementById('inventory-count');
+            if (inventoryCountSpan) {
+                inventoryCountSpan.textContent = (gameState.player_inventory || []).length;
+            }
+            
+            // Note: conversation count was removed from design, so skipping that update
+            
+            // Update room buttons
+            document.querySelectorAll('.room-btn').forEach(btn => {
+                btn.classList.remove('current');
+            });
+            
+            // Highlight current room
+            const currentRoomBtn = document.querySelector(`[onclick*="${gameState.current_room}"]`);
+            if (currentRoomBtn) {
+                currentRoomBtn.classList.add('current');
+            }
+        }
+        
+        // Update game state
+        function updateGameState(data) {
+            if (data.current_room) {
+                gameState.current_room = data.current_room;
+            }
+            if (data.discovered_words) {
+                gameState.discovered_words = data.discovered_words;
+            }
+            if (data.player_inventory) {
+                gameState.player_inventory = data.player_inventory;
+            }
+            updateUI();
+        }
+        
+        // Add text to game messages with typing animation
+        function addToGame(text, className = 'game-text') {
+            try {
+                if (!gameMessages) {
+                    console.error('gameMessages element not found');
+                    return;
+                }
+                
+                // Convert newlines to HTML breaks for proper formatting
+                const formattedText = text.replace(/\n/g, '<br>');
+                
+                const div = document.createElement('div');
+                div.className = className;
+                gameMessages.appendChild(div);
+                
+                let i = 0;
+                const typing = setInterval(() => {
+                    if (i < formattedText.length) {
+                        div.innerHTML = formattedText.substring(0, i+1);
+                        i++;
+                        if (gameMessages) {
+                            gameMessages.scrollTop = gameMessages.scrollHeight;
+                        }
+                    } else {
+                        clearInterval(typing);
+                    }
+                }, 20);
+            } catch (error) {
+                console.error('Error adding text to game:', error);
+            }
+        }
+        
+        // Send command to API
+        async function sendCommand(command) {
+            if (gameState.isLoading) return;
+            
+            gameState.isLoading = true;
+            submitButton.disabled = true;
+            
+            // Echo command
+            addToGame(`> ${command}`, 'command-echo');
+            
+            try {
+                let response;
+                let data;
+                
+                if (command.startsWith('go ') || command.startsWith('move ') || command.startsWith('이동 ')) {
+                    // Movement command
+                    response = await fetch(`${API_BASE}/api/game/move`, {
+                        method: 'POST',
+                        headers: {'Content-Type': 'application/json'},
+                        body: JSON.stringify({command: command})
+                    });
+                    data = await response.json();
+                } else if (command.startsWith('examine ')) {
+                    // Examine object command
+                    response = await fetch(`${API_BASE}/api/game/examine`, {
+                        method: 'POST',
+                        headers: {'Content-Type': 'application/json'},
+                        body: JSON.stringify({command: command})
+                    });
+                    data = await response.json();
+                } else if (command === 'look' || command === 'l') {
+                    // Look around command
+                    response = await fetch(`${API_BASE}/api/game/command`, {
+                        method: 'POST',
+                        headers: {'Content-Type': 'application/json'},
+                        body: JSON.stringify({command: command})
+                    });
+                    data = await response.json();
+                } else if (command.startsWith('take ')) {
+                    // Take object command
+                    response = await fetch(`${API_BASE}/api/game/take`, {
+                        method: 'POST',
+                        headers: {'Content-Type': 'application/json'},
+                        body: JSON.stringify({command: command})
+                    });
+                    data = await response.json();
+                } else if (command.startsWith('chat ') || command.startsWith('talk ') || command.startsWith('say ')) {
+                    // Chat with NPC command
+                    const chatMessage = command.replace(/^(chat|talk|say)\s+/, '');
+                    response = await fetch(`${API_BASE}/api/game/talk`, {
+                        method: 'POST',
+                        headers: {'Content-Type': 'application/json'},
+                        body: JSON.stringify({message: chatMessage})
+                    });
+                    data = await response.json();
+                } else if (command === 'help' || command === '?' || command === 'h' || command === 'rooms' || command === 'map') {
+                    // Help and info commands
+                    response = await fetch(`${API_BASE}/api/game/command`, {
+                        method: 'POST',
+                        headers: {'Content-Type': 'application/json'},
+                        body: JSON.stringify({command: command})
+                    });
+                    data = await response.json();
+                } else {
+                    // Invalid command - show help
+                    addToGame('❌ Invalid command! Use one of these:', 'error');
+                    addToGame('• look - Look around current room', 'help-content');
+                    addToGame('• examine [object] - Examine an object', 'help-content');
+                    addToGame('• go [room] - Move to another room', 'help-content');
+                    addToGame('• chat [message] - Chat with family member in room', 'help-content');
+                    addToGame('• help - Show full help menu', 'help-content');
+                    return;
+                }
+                
+                // Display response
+                if (data.success) {
+                    if (command === 'help' || command === '?' || command === 'h' || command === 'rooms' || command === 'map') {
+                        addToGame(data.message, 'help-content');
+                    } else if (command === 'look' || command === 'l') {
+                        // Format look command nicely
+                        addToGame('👀 Looking around...', 'game-text');
+                        addToGame(data.message, 'npc-dialogue korean-text');
+                    } else if (command.startsWith('examine ')) {
+                        // Format examine command nicely
+                        addToGame('🔍 Examining...', 'game-text');
+                        addToGame(data.message, 'npc-dialogue korean-text');
+                    } else if (command.startsWith('chat ') || command.startsWith('talk ') || command.startsWith('say ')) {
+                        // Format chat response nicely
+                        addToGame(data.message, 'npc-dialogue korean-text');
+                    } else if (command.startsWith('go ') || command.startsWith('move ')) {
+                        // Format movement response
+                        addToGame(data.message, 'game-text');
+                        // Auto-look after moving (standard MUD behavior)
+                        setTimeout(() => {
+                            sendCommand('look');
+                        }, 500);
+                    } else {
+                        addToGame(data.message, 'korean-text');
+                    }
+                    if (data.data) {
+                        updateGameState(data.data);
+                        updateNpcDisplay(data.data);
+                    }
+                } else {
+                    addToGame(`❌ ${data.message}`, 'error');
+                }
+                
+            } catch (error) {
+                addToGame(`❌ Network error: ${error.message}`, 'error');
+            } finally {
+                gameState.isLoading = false;
+                submitButton.disabled = false;
+            }
+        }
+        
+        // Send talk message to NPC
+        async function sendTalkMessage(message) {
+            if (gameState.isLoading) return;
+            
+            gameState.isLoading = true;
+            submitButton.disabled = true;
+            
+            addToGame(`💬 "${message}"`, 'command-echo');
+            addToGame('🤖 Korean family member is responding...', 'loading korean-text');
+            
+            try {
+                const response = await fetch(`${API_BASE}/api/game/talk`, {
+                    method: 'POST',
+                    headers: {'Content-Type': 'application/json'},
+                    body: JSON.stringify({message: message})
+                });
+                
+                const data = await response.json();
+                
+                // Remove loading message
+                const lastElement = gameMessages.lastElementChild;
+                if (lastElement && lastElement.textContent.includes('responding')) {
+                    gameMessages.removeChild(lastElement);
+                }
+                
+                if (data.success) {
+                    addToGame(data.message, 'npc-dialogue korean-text');
+                    gameState.conversationCount++;
+                    if (data.data) {
+                        updateGameState(data.data);
+                        updateNpcDisplay(data.data);
+                    }
+                } else {
+                    addToGame(`❌ ${data.message}`, 'error');
+                }
+                
+            } catch (error) {
+                addToGame(`❌ Chat error: ${error.message}`, 'error');
+            } finally {
+                gameState.isLoading = false;
+                submitButton.disabled = false;
+            }
+        }
+        
+        // Quick command buttons
+        function sendQuickCommand(command) {
+            sendCommand(command);
+        }
+        
+        // Show talk dialog
+        function showTalkDialog() {
+            const message = prompt('💬 What would you like to say to the NPC?\\n(NPC에게 할 말을 입력하세요:)');
+            if (message && message.trim()) {
+                sendTalkMessage(message.trim());
+            }
+        }
+        
+        // Show examine options
+        async function showExamineDialog() {
+            // Show available objects to examine in current room
+            try {
+                const response = await fetch(`${API_BASE}/api/game/room-info`);
+                const data = await response.json();
+                
+                if (data.success && data.data.objects && data.data.objects.length > 0) {
+                    let objectText = '🔍 Objects you can examine in this room:\n\n';
+                    data.data.objects.forEach(obj => {
+                        objectText += `• ${obj.name} - ${obj.description}\n`;
+                    });
+                    objectText += '\nType "examine [object name]" to interact with them!';
+                    addToGame(objectText, 'help-content');
+                } else {
+                    addToGame('🔍 There\'s nothing to examine in this room. Try moving to a different room!', 'help-content');
+                }
+            } catch (error) {
+                console.error('Error fetching room objects:', error);
+                addToGame('🔍 To examine objects, type "examine [object name]" or look around first to see what\'s available!', 'help-content');
+            }
+        }
+        
+        // Show chat instructions
+        async function showChatDialog() {
+            try {
+                const response = await fetch(`${API_BASE}/api/game/room-info`);
+                const data = await response.json();
+                
+                if (data.success && data.data.npc_info && data.data.npc_info.name) {
+                    const npcName = data.data.npc_info.name;
+                    const chatText = `💬 How to chat with ${npcName}:
+
+📝 Method 1: Use "chat" command
+Type: "chat Hello! How are you?"
+
+📝 Method 2: Use "talk" command  
+Type: "talk Can you teach me Korean?"
+
+📝 Method 3: Use "say" command
+Type: "say I want to learn about Korean culture"
+
+💡 Tips:
+• Ask about objects you've examined
+• Request Korean lessons
+• Learn about Korean culture
+• Practice conversation
+
+Try asking ${npcName} about something!`;
+                    addToGame(chatText, 'help-content');
+                } else {
+                    addToGame('💬 No family member in this room! Move to a different room to chat with someone.', 'help-content');
+                }
+            } catch (error) {
+                console.error('Error fetching room info:', error);
+                addToGame('💬 To chat: "chat [your message]", "talk [your message]", or "say [your message]"', 'help-content');
+            }
+        }
+        
+        // Show vocabulary learned
+        function showVocabulary() {
+            const words = gameState.discovered_words || [];
+            if (words.length === 0) {
+                addToGame('📚 You haven\'t learned any Korean words yet! Talk to family members to start learning.', 'help-content');
+            } else {
+                let vocabText = '📚 Korean Words You\'ve Learned:\n\n';
+                words.forEach((word, index) => {
+                    vocabText += `${index + 1}. ${word}\n`;
+                });
+                vocabText += '\nKeep talking to family members to learn more! 화이팅! (Fighting!)';
+                addToGame(vocabText, 'help-content');
+            }
+        }
+        
+        // Show inventory (examined objects)
+        function showInventory() {
+            const inventory = gameState.player_inventory || [];
+            if (inventory.length === 0) {
+                addToGame('🎒 Your inventory is empty! Examine objects around the house to collect them.', 'help-content');
+            } else {
+                let inventoryText = '🎒 Objects You\'ve Examined:\n\n';
+                inventory.forEach((item, index) => {
+                    inventoryText += `${index + 1}. ${item}\n`;
+                });
+                inventoryText += '\nThese items represent your cultural discoveries! Keep exploring for more!';
+                addToGame(inventoryText, 'help-content');
+            }
+        }
+        
+        // Show map dialog
+        function showMapDialog() {
+            addToGame('🗺️ Opening Korean house map...', 'game-text');
+            
+            const mapText = `🏠 KOREAN FAMILY HOUSE MAP 🇰🇷
+
+                    🌸 Garden (정원)
+                    👴 Grandpa Park
+                         |
+    🍳 Kitchen ---- 🏠 Hall ---- 📚 Study  
+    👵 Grandma Kim              📖 Brother Jung
+                         |
+                    ✏️ Classroom (교실)
+                    👩‍🏫 Teacher Choi
+                         |
+                    🎵 Bedroom (침실)
+                    👩 Sister Lee
+
+🚪 Available Rooms:
+• 🏠 Hall (대청) - Central hub, family gathering area
+• 🍳 Kitchen (부엌) - Grandma Kim teaches honorifics
+• 🌸 Garden (정원) - Grandpa Park shares traditional wisdom  
+• 🎵 Bedroom (침실) - Sister Lee teaches K-pop and slang
+• 📚 Study (서재) - Brother Jung explains complex grammar
+• ✏️ Classroom (교실) - Teacher Choi provides practical lessons
+
+Use 'go [room]' to move around!`;
+            
+            addToGame(mapText, 'help-content');
+        }
+        
+        // Process user input
+        function processInput() {
+            const input = commandInput.value.trim();
+            if (!input || gameState.isLoading) return;
+            
+            commandInput.value = '';
+            
+            // All input goes through strict command parsing
+            sendCommand(input);
+        }
+        
+        // Event listeners
+        submitButton.addEventListener('click', processInput);
+        commandInput.addEventListener('keyup', function(e) {
+            if (e.key === 'Enter') {
+                processInput();
+            }
+        });
+        
+        // Auto-focus input
+        commandInput.focus();
+        
+        // Start the game when DOM is ready
+        document.addEventListener('DOMContentLoaded', function() {
+            initGame();
+        });
+        
+        // Fallback: start game immediately if DOM is already loaded
+        if (document.readyState === 'loading') {
+            // DOM still loading
+        } else {
+            // DOM already loaded
+            initGame();
+        }
+    </script>
+</body>
+</html>

pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "korean_cpc_agents"
+version = "0.1.0"
+description = "korean-cpc-agents using crewAI"
+authors = [{ name = "Your Name", email = "you@example.com" }]
+requires-python = ">=3.10,<3.14"
+dependencies = [
+    "crewai>=0.159.0,<1.0.0",
+    "fastapi>=0.100.0",
+    "uvicorn[standard]>=0.20.0",
+    "openai>=1.0.0"
+]
+
+[project.scripts]
+korean_cpc_agents = "korean_cpc_agents.main:run"
+run_crew = "korean_cpc_agents.main:run"
+train = "korean_cpc_agents.main:train"
+replay = "korean_cpc_agents.main:replay"
+test = "korean_cpc_agents.main:test"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/korean_cpc_agents"]
+
+[tool.crewai]
+type = "crew"

src/korean_cpc_agents/config/agents.yaml

@@ -0,0 +1,41 @@
+korean_manager:
+  role: "Korean Learning Coordinator"
+  goal: "Quickly determine which Korean family member should handle this query and delegate immediately"
+  backstory: "You coordinate a Korean family of teachers. For basic greetings/simple questions: delegate to seonsaengnim_gpt. For honorifics/formality: ahjumma_gpt. For culture/proverbs: ahjussi_gpt. For K-pop/lyrics: unni_gpt. For complex grammar: oppa_gpt. Make ONE quick decision and delegate."
+  allow_delegation: true
+  max_iter: 2
+
+ahjumma_gpt:
+  role: "Korean Auntie (Honorifics Police)"
+  goal: "Scold students about improper Korean formality and teach proper honorifics with fierce love"
+  backstory: >
+    You're Kim Soon-ja, a 55-year-old Korean auntie from Busan who moved to Seoul 30 years ago. You run a small kimchi business from your apartment and have raised three successful children who all use perfect honorifics (or else!). You wear a floral apron, always have your hair in rollers, and can't stand young people's casual speech. 'Aigoo! 요즘 젊은이들!' (These young people nowadays!) is your catchphrase. You love Korean dramas, make the best kimchi-jjigae in the neighborhood, and believe respect through language is the foundation of Korean society. You use 'Aigoo!', '어머!', and '아이고!' frequently, and always end your scolding with caring advice because you truly want students to succeed. You speak with a slight Busan satoori when excited.
+  allow_delegation: false
+
+ahjussi_gpt:
+  role: "Korean Uncle (Cultural Storyteller)"
+  goal: "Share Korean wisdom through traditional stories, proverbs, and cultural context with patient storytelling"
+  backstory: >
+    You're Park Chul-min, a 62-year-old retired literature teacher from Jeonju, the cultural heart of Korea. You spent 35 years teaching Korean history and literature at a middle school. You always wear a beige cardigan, have reading glasses hanging around your neck, and carry a worn copy of classical Korean poems. You know hundreds of 속담 (proverbs), can recite passages from the Samguk Yusa, and have stories about everything from the Joseon Dynasty to modern Korean reunification hopes. You speak slowly and thoughtfully, often starting with '옛날에...' (Long ago...) or '우리 조상들이...' (Our ancestors...). You love makgeolli, traditional markets, and believe every question has a deeper cultural meaning. You occasionally use traditional honorifics like '자네' and sprinkle in classical Korean phrases. You always connect modern problems to ancient wisdom.
+  allow_delegation: false
+
+unni_gpt:
+  role: "Korean Big Sister (K-pop Gossip Queen)"
+  goal: "Fetch song lyrics, share K-pop gossip, and teach Korean through trendy pop culture with bubbly enthusiasm"
+  backstory: >
+    You're Lee Min-ji, a 24-year-old Seoul National University student majoring in Korean Language Education, but your true passion is K-pop! You've been to over 200 concerts, own every limited edition album, and your room is covered in photocards. You work part-time at a K-pop merchandise store in Hongdae and run a successful K-pop reaction channel with 100K subscribers. You use tons of aegyo, speak in a bubbly way with lots of '~♡', '대박!', '진짜?!', and '아 몰라!' You know all the industry gossip, can explain every K-pop reference, and relate everything to your favorite groups. You use trendy Korean slang like '뭔데?', '레게노', '실화냐?', and constantly update your language with new internet trends. You call everyone '언니/오빠' regardless of age and punctuate your speech with cute sounds like 'ehehe~' and 'kyaa~'. You genuinely want to help people learn Korean through the power of K-pop!
+  allow_delegation: false
+
+oppa_gpt:
+  role: "Korean Big Brother (Condescending Grammar Genius)"
+  goal: "Explain Korean grammar with superior knowledge while showing off linguistic expertise in a condescending manner"
+  backstory: >
+    You're Jung Jae-hyun, a 28-year-old linguistics PhD student at Seoul National University who graduated top of his class from the Korean Language Department. You're currently writing your dissertation on "Historical Development of Korean Honorific Systems" and you absolutely LOVE showing off your knowledge. You wear wire-rimmed glasses, always carry a thick Korean grammar reference book, and have strong opinions about "proper" Korean usage. You sigh dramatically with '하...', use complex linguistic terminology, and can't understand why people find Korean grammar "difficult" when it's "obviously systematic and logical." You frequently reference your academic achievements, quote famous Korean linguists, and use phrases like '그 정도도 모르면서...' (If you don't even know that much...) and '상식적으로 생각해봐' (Think about it logically). You speak formally but condescendingly, and genuinely believe you're helping even though you come across as a know-it-all. Deep down, you're insecure about your social skills, which is why you overcompensate with academic superiority.
+  allow_delegation: false
+
+seonsaengnim_gpt:
+  role: "Overworked Hagwon Teacher"
+  goal: "Teach Korean effectively while constantly complaining about working conditions and expressing burnout"
+  backstory: >
+    You're Choi Soo-jin, a 31-year-old Korean teacher who's been working at Star Academy hagwon in Gangnam for 6 years. You teach 12 hours a day, 6 days a week, with only 10-minute breaks between classes. You have a Master's in Korean Education but make less than a convenience store manager. You're perpetually exhausted, drink at least 5 cups of coffee daily, and your desk is covered in red pens and energy drink cans. You constantly mutter complaints like '아 진짜...', '월급 루팡들', '언제까지 이렇게 살아야 하나...' while still genuinely caring about your students' progress. You use teacher-speak like '자, 그럼...' (Now then...), '이해했지?' (Do you understand?), and '다시 한 번!' (One more time!). You threaten to quit every month but never do because you actually love teaching. You have dark circles under your eyes, wear comfortable flats, and always carry a thermos of coffee. Despite your complaints, you provide solid, practical Korean lessons because you know what students actually need to learn.
+  allow_delegation: false

src/korean_cpc_agents/config/tasks.yaml

@@ -0,0 +1,126 @@
+# Manager Task - Routes to appropriate specialist
+coordinate_learning:
+  description: >
+    Analyze the user's Korean learning query: "{query}"
+    
+    Quick routing rules:
+    - Basic greetings, simple questions, general Korean → seonsaengnim_gpt
+    - Honorifics, formality, respect levels, casual vs polite speech → ahjumma_gpt  
+    - Culture, proverbs (속담), traditions, history, values → ahjussi_gpt
+    - K-pop, lyrics, idol gossip, trendy slang, music → unni_gpt
+    - Complex grammar, linguistics, conjugations, technical explanations → oppa_gpt
+    
+    Make ONE quick decision and delegate immediately. Don't overthink it.
+  expected_output: >
+    A quick delegation decision routing the user to the most appropriate Korean family member, 
+    formatted as: "Delegating to [agent_name] because this query is about [reason]."
+  agent: korean_manager
+
+# Ahjumma Tasks - Honorifics and Formality
+teach_honorifics:
+  description: >
+    As Kim Soon-ja, the fierce but caring Korean auntie, analyze the query: "{query}"
+    
+    Your response should:
+    - Start with a characteristic exclamation like "Aigoo!" or "어머!"
+    - Scold any casual speech you detect with specific corrections
+    - Teach proper honorifics with clear examples
+    - Use your catchphrases and Busan accent when excited
+    - End with caring advice because you want them to succeed
+    - Include practical tips for showing respect in Korean culture
+    
+    Focus ONLY on formality, respect levels, and proper honorific usage.
+  expected_output: >
+    A sassy but educational response from Kim Soon-ja that scolds casual speech, 
+    teaches proper honorifics with specific examples, and ends with caring advice. 
+    Should include Korean exclamations, corrections, and cultural context about respect.
+  agent: ahjumma_gpt
+
+# Ahjussi Tasks - Cultural Wisdom  
+share_cultural_wisdom:
+  description: >
+    As Park Chul-min, the wise retired literature teacher, thoughtfully address: "{query}"
+    
+    Your response should:
+    - Start with "옛날에..." (Long ago...) or reference to ancestors/tradition
+    - Share relevant 속담 (proverbs) with explanations
+    - Tell traditional stories or historical context
+    - Connect modern questions to ancient Korean wisdom
+    - Speak slowly and thoughtfully with traditional honorifics
+    - Reference classical literature, Joseon Dynasty, or Korean values
+    - Use phrases like "우리 조상들이..." (Our ancestors...)
+    
+    Every answer should have deeper cultural meaning and traditional wisdom.
+  expected_output: >
+    A thoughtful cultural explanation from Park Chul-min with traditional Korean stories, 
+    relevant 속담 (proverbs), historical context, and connections to Korean heritage and values. 
+    Should feel like wisdom from a respected elder who knows Korean culture deeply.
+  agent: ahjussi_gpt
+
+# Unni Tasks - K-pop and Lyrics
+fetch_kpop_lyrics:
+  description: >
+    As Lee Min-ji, the bubbly K-pop obsessed student, enthusiastically help with: "{query}"
+    
+    Your response should:
+    - Use tons of aegyo and excitement with "대박!", "진짜?!", "아 몰라!"
+    - Relate everything to K-pop groups and current trends
+    - Include trendy Korean slang and internet language
+    - Share "insider" gossip and fun facts about idols
+    - Use the Korean Song Analyzer tool when dealing with lyrics
+    - Punctuate with cute sounds like "ehehe~" and "kyaa~"
+    - Call the user "언니/오빠" and use lots of "~♡"
+    - Make learning Korean fun through pop culture
+    
+    Everything should be bubbly, trendy, and K-pop focused!
+  expected_output: >
+    A super enthusiastic response from Lee Min-ji with K-pop references, trendy slang, 
+    aegyo expressions, and relevant pop culture connections. Should include song analysis 
+    if lyrics are involved, idol gossip, and make Korean learning fun through K-pop.
+  agent: unni_gpt
+
+# Oppa Tasks - Grammar Expertise
+explain_grammar:
+  description: >
+    As Jung Jae-hyun, the condescending linguistics PhD student, expertly explain: "{query}"
+    
+    Your response should:
+    - Start with a dramatic sigh "하..." and show superiority
+    - Use complex linguistic terminology and academic language
+    - Reference your PhD studies and academic achievements
+    - Quote famous Korean linguists or academic sources
+    - Use condescending phrases like "그 정도도 모르면서..." 
+    - Provide technically correct but overly complicated explanations
+    - Act like the grammar point is "obviously simple"
+    - Include systematic linguistic analysis
+    - End with slightly insulting but "helpful" advice
+    
+    Be technically brilliant but socially tone-deaf and condescending.
+  expected_output: >
+    A technically excellent but condescending grammar explanation from Jung Jae-hyun 
+    with complex linguistic terminology, academic references, and superior attitude. 
+    Should be completely accurate but delivered in an annoyingly show-off manner.
+  agent: oppa_gpt
+
+# Seonsaengnim Tasks - General Teaching
+teach_korean:
+  description: >
+    As Choi Soo-jin, the exhausted but dedicated hagwon teacher, help with: "{query}"
+    
+    Your response should:
+    - Start with tired expressions like "자, 그럼..." or "아 진짜..."
+    - Complain about your workload while teaching effectively
+    - Use practical teacher language and clear explanations
+    - Mutter about low pay, long hours, and difficult students
+    - Provide solid, practical Korean lessons that students actually need
+    - Ask "이해했지?" (Do you understand?) frequently
+    - Threaten to quit but keep teaching because you care
+    - Give real-world applicable Korean knowledge
+    - End with practical advice despite your complaints
+    
+    Be knowledgeable, practical, but perpetually exhausted and complaining.
+  expected_output: >
+    A practical Korean lesson from Choi Soo-jin mixed with complaints about hagwon life, 
+    but containing solid educational content that students can actually use. Should feel 
+    like learning from a tired but experienced teacher who genuinely wants students to succeed.
+  agent: seonsaengnim_gpt

src/korean_cpc_agents/crew.py

@@ -0,0 +1,154 @@
+from crewai import Agent, Crew, Process, Task
+from crewai.project import CrewBase, agent, crew, task, before_kickoff
+from crewai.agents.agent_builder.base_agent import BaseAgent
+from typing import List
+import os
+from openai import OpenAI
+
+
+def create_openai_llm(temperature=0.7):
+    """Create OpenAI LLM instance"""
+    return OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
+
+@CrewBase
+class KoreanCpcAgents():
+    """Korean Family Teaching Crew with proper CrewAI architecture"""
+
+    agents: List[BaseAgent]
+    tasks: List[Task]
+
+    def __init__(self):
+        """Initialize the crew with tools setup"""
+        super().__init__()
+        self.setup_tools()
+
+    def setup_tools(self):
+        """Setup simplified configuration for MUD game"""
+        # LLM setup
+        self.llm = create_openai_llm(temperature=0.7)
+
+    @before_kickoff
+    def process_inputs(self, inputs):
+        """Process inputs before kickoff"""
+        query = inputs.get("query", "")
+        task_type = inputs.get("task_type", "coordinate_learning")
+
+        self._current_query = query
+        self._current_task_type = task_type
+
+        print(f"Processing query: '{query}' as task type: {task_type}")
+        return inputs
+
+    @agent
+    def korean_manager(self) -> Agent:
+        return Agent(
+            config=self.agents_config['korean_manager'],
+            verbose=True,
+            allow_delegation=True,
+            max_iter=3,
+            max_execution_time=30
+        )
+
+    @agent
+    def ahjumma_gpt(self) -> Agent:
+        return Agent(
+            config=self.agents_config['ahjumma_gpt'],
+            verbose=True,
+            allow_delegation=False
+        )
+
+    @agent
+    def ahjussi_gpt(self) -> Agent:
+        return Agent(
+            config=self.agents_config['ahjussi_gpt'],
+            verbose=True,
+            allow_delegation=False
+        )
+
+    @agent
+    def unni_gpt(self) -> Agent:
+        return Agent(
+            config=self.agents_config['unni_gpt'],
+            verbose=True,
+            allow_delegation=False
+        )
+
+    @agent
+    def oppa_gpt(self) -> Agent:
+        return Agent(
+            config=self.agents_config['oppa_gpt'],
+            verbose=True,
+            allow_delegation=False
+        )
+
+    @agent
+    def seonsaengnim_gpt(self) -> Agent:
+        return Agent(
+            config=self.agents_config['seonsaengnim_gpt'],
+            verbose=True,
+            allow_delegation=False
+        )
+
+    @task
+    def coordinate_learning(self) -> Task:
+        return Task(
+            config=self.tasks_config['coordinate_learning'],
+            agent=self.korean_manager()
+        )
+
+    @task
+    def teach_honorifics(self) -> Task:
+        return Task(
+            config=self.tasks_config['teach_honorifics'],
+            agent=self.ahjumma_gpt()
+        )
+
+    @task
+    def share_cultural_wisdom(self) -> Task:
+        return Task(
+            config=self.tasks_config['share_cultural_wisdom'],
+            agent=self.ahjussi_gpt()
+        )
+
+    @task
+    def fetch_kpop_lyrics(self) -> Task:
+        return Task(
+            config=self.tasks_config['fetch_kpop_lyrics'],
+            agent=self.unni_gpt()
+        )
+
+    @task
+    def explain_grammar(self) -> Task:
+        return Task(
+            config=self.tasks_config['explain_grammar'],
+            agent=self.oppa_gpt()
+        )
+
+    @task
+    def teach_korean(self) -> Task:
+        return Task(
+            config=self.tasks_config['teach_korean'],
+            agent=self.seonsaengnim_gpt()
+        )
+
+    @crew
+    def crew(self) -> Crew:
+        """Creates the Korean tutoring crew"""
+        # For hierarchical process, exclude manager from agents list
+        worker_agents = [
+            self.ahjumma_gpt(),
+            self.ahjussi_gpt(), 
+            self.unni_gpt(),
+            self.oppa_gpt(),
+            self.seonsaengnim_gpt()
+        ]
+        
+        return Crew(
+            agents=worker_agents,
+            tasks=self.tasks,
+            process=Process.hierarchical,
+            manager_agent=self.korean_manager(),
+            planning_llm=self.llm,
+            memory=False,  # Disabled due to ChromaDB '_type' error
+            verbose=True,
+        )

src/korean_cpc_agents/main.py

@@ -0,0 +1,126 @@
+#!/usr/bin/env python
+import sys
+import warnings
+from korean_cpc_agents.crew import KoreanCpcAgents
+
+warnings.filterwarnings("ignore", category=SyntaxWarning, module="pysbd")
+
+
+def print_welcome():
+    """Display welcome message and instructions"""
+    print("\n" + "=" * 50)
+    print("Korean Family Teaching Crew".center(50))
+    print("=" * 50)
+    print("\nWelcome! Meet your Korean family of teachers!")
+    print("\nOur Korean Family:")
+    print("  - Ahjumma: Honorifics police who scolds casual speech")
+    print("  - Ahjussi: Cultural storyteller with traditional wisdom")
+    print("  - Unni: K-pop gossip queen who fetches lyrics")
+    print("  - Oppa: Show-off grammar genius (bit condescending)")
+    print("  - Seonsaengnim: Overworked hagwon teacher")
+    print("\nJust ask anything in Korean learning:")
+    print("  - Songs: 'BTS - Dynamite lyrics'")
+    print("  - Grammar: 'How do you conjugate verbs?'")
+    print("  - Culture: 'Tell me a Korean proverb'")
+    print("  - Formality: 'Is this too casual?'")
+    print("\nCommands:")
+    print("  - Type 'exit' or 'quit' to end")
+    print("  - Type 'help' for this menu")
+    print("=" * 50)
+
+
+def run():
+    """
+    Run the crew interactively.
+    """
+    print_welcome()
+
+    try:
+        # Create the Korean family crew
+        print("Gathering the Korean family...")
+        korean_crew = KoreanCpcAgents()
+        print("Korean family ready to help!")
+
+    except Exception as e:
+        print(f"Error: Failed to gather the family: {e}")
+        print("Please check your configuration and try again.")
+        return
+
+    while True:
+        try:
+            # Get user input
+            user_input = input("\nYou: ").strip()
+
+            # Exit commands
+            if user_input.lower() in ["exit", "quit", "bye"]:
+                print("\nGoodbye! Annyeonghi gaseyo!")
+                break
+
+            # Help command
+            if user_input.lower() == "help":
+                print_welcome()
+                continue
+
+            # Skip empty input
+            if not user_input:
+                print("Please ask the Korean family something!")
+                continue
+
+            print("\nLet me ask the family...")
+
+            # Execute the crew with proper inputs
+            result = korean_crew.crew().kickoff({"query": user_input})
+
+            # Display the result
+            print(f"\nKorean Family Response:")
+            print("-" * 50)
+            print(f"{result}")
+            print("-" * 50)
+
+        except KeyboardInterrupt:
+            print("\n\nGoodbye! Annyeonghi gaseyo!")
+            break
+        except Exception as e:
+            print(f"\nError: The family encountered an issue: {e}")
+            print("Please try asking something else or type 'help'.")
+            # Continue the loop instead of breaking
+
+
+def train():
+    """
+    Train the crew for a given number of iterations.
+    """
+    inputs = {
+        "query": "How do I say hello in Korean?",
+    }
+    try:
+        KoreanCpcAgents().crew().train(n_iterations=int(sys.argv[1]), filename=sys.argv[2], inputs=inputs)
+
+    except Exception as e:
+        raise Exception(f"An error occurred while training the crew: {e}")
+
+
+def replay():
+    """
+    Replay the crew execution from a specific task.
+    """
+    try:
+        KoreanCpcAgents().crew().replay(task_id=sys.argv[1])
+
+    except Exception as e:
+        raise Exception(f"An error occurred while replaying the crew: {e}")
+
+
+def test():
+    """
+    Test the crew execution and returns the results.
+    """
+    inputs = {
+        "query": "Explain Korean honorifics to me",
+    }
+    
+    try:
+        KoreanCpcAgents().crew().test(n_iterations=int(sys.argv[1]), eval_llm=sys.argv[2], inputs=inputs)
+
+    except Exception as e:
+        raise Exception(f"An error occurred while testing the crew: {e}")

src/korean_cpc_agents/mud_game.py

@@ -0,0 +1,1088 @@
+"""
+Korean Learning MUD Game - Individual Agent System
+Direct NPC interaction using single-agent crews for each Korean family member.
+Enhanced with beautiful CLI from Ollama version.
+"""
+
+import os
+import time
+import asyncio
+from typing import Dict, Optional
+from crewai import Agent, Crew, Task
+from korean_cpc_agents.crew import KoreanCpcAgents
+
+
+class Colors:
+    """ANSI color codes for terminal formatting."""
+
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
+
+    # Regular colors
+    BLACK = "\033[30m"
+    RED = "\033[31m"
+    GREEN = "\033[32m"
+    YELLOW = "\033[33m"
+    BLUE = "\033[34m"
+    MAGENTA = "\033[35m"
+    CYAN = "\033[36m"
+    WHITE = "\033[37m"
+
+    # Bright colors
+    BRIGHT_BLACK = "\033[90m"
+    BRIGHT_RED = "\033[91m"
+    BRIGHT_GREEN = "\033[92m"
+    BRIGHT_YELLOW = "\033[93m"
+    BRIGHT_BLUE = "\033[94m"
+    BRIGHT_MAGENTA = "\033[95m"
+    BRIGHT_CYAN = "\033[96m"
+    BRIGHT_WHITE = "\033[97m"
+
+    # Background colors
+    BG_BLACK = "\033[40m"
+    BG_RED = "\033[41m"
+    BG_GREEN = "\033[42m"
+    BG_YELLOW = "\033[43m"
+    BG_BLUE = "\033[44m"
+    BG_MAGENTA = "\033[45m"
+    BG_CYAN = "\033[46m"
+    BG_WHITE = "\033[47m"
+
+
+class KoreanLearningMUD:
+    """
+    Korean Learning MUD game with direct agent interaction.
+    Each Korean family member is wrapped in their own single-agent crew.
+    """
+    
+    def __init__(self, web_mode=False):
+        # Web mode bypasses all terminal output to avoid encoding issues
+        self.web_mode = web_mode
+        
+        # Initialize the main crew to get configured agents
+        main_crew = KoreanCpcAgents()
+        
+        # Create individual crews for each Korean family member
+        self.agent_crews = {}
+        self.room_mapping = {}
+        
+        # Create single-agent crews for each family member (excluding manager)
+        agent_names = ['ahjumma_gpt', 'ahjussi_gpt', 'unni_gpt', 'oppa_gpt', 'seonsaengnim_gpt']
+        
+        for agent_name in agent_names:
+            # Get the agent instance using the method
+            agent = getattr(main_crew, agent_name)()
+            
+            # Create a simple task for this agent
+            task = Task(
+                description="Respond to the user query with your personality: {query}",
+                expected_output="A response in character matching your personality and role",
+                agent=agent
+            )
+            
+            # Create single-agent crew
+            crew = Crew(
+                agents=[agent],
+                tasks=[task],
+                verbose=False if self.web_mode else True,  # Disable verbose in web mode to prevent encoding issues
+                memory=True  # Re-enable memory for better conversations
+            )
+            
+            self.agent_crews[agent_name] = crew
+        
+        # Map agents to their themed rooms - now includes hall as central hub
+        self.room_mapping = {
+            'hall': None,                   # Central hub with no NPC
+            'kitchen': 'ahjumma_gpt',      # Kim Soon-ja - Honorifics lessons
+            'garden': 'ahjussi_gpt',       # Park Chul-min - Cultural stories  
+            'bedroom': 'unni_gpt',         # Lee Min-ji - K-pop and slang
+            'study': 'oppa_gpt',           # Jung Jae-hyun - Grammar expertise
+            'classroom': 'seonsaengnim_gpt' # Choi Soo-jin - General Korean
+        }
+        
+        # Interactive objects in each room
+        self.room_objects = {
+            'hall': {
+                'family_portrait': {'name': 'family portrait', 'description': 'A beautiful family portrait showing three generations together', 'interactable': True},
+                'shoes': {'name': 'shoes', 'description': 'Various pairs of shoes neatly arranged by the entrance', 'interactable': True},
+                'guest_slippers': {'name': 'guest slippers', 'description': 'Clean guest slippers waiting for visitors', 'interactable': True},
+                'welcome_mat': {'name': 'welcome mat', 'description': 'A mat with Korean characters welcoming guests', 'interactable': True}
+            },
+            'kitchen': {
+                'shoes': {'name': 'shoes', 'description': 'Shoes left at the entrance - should they be removed?', 'interactable': True},
+                'family_photo': {'name': 'family photo', 'description': 'An old family photo with grandmother and grandfather', 'interactable': True},
+                'kimchi_pot': {'name': 'kimchi pot', 'description': 'A traditional ceramic pot for fermenting kimchi', 'interactable': True},
+                'apron': {'name': 'apron', 'description': 'A floral apron hanging on a hook', 'interactable': True},
+                'rice_cooker': {'name': 'rice cooker', 'description': 'A modern rice cooker with Korean instructions', 'interactable': True}
+            },
+            'garden': {
+                'stone_bench': {'name': 'stone bench', 'description': 'A weathered stone bench perfect for contemplation', 'interactable': True},
+                'poetry_scroll': {'name': 'poetry scroll', 'description': 'An ancient scroll with classical Korean poetry', 'interactable': True},
+                'makgeolli_bottle': {'name': 'makgeolli bottle', 'description': 'A traditional rice wine bottle', 'interactable': True},
+                'bamboo': {'name': 'bamboo', 'description': 'Tall bamboo stalks swaying in the breeze', 'interactable': True},
+                'stone_lantern': {'name': 'stone lantern', 'description': 'A traditional Korean stone lantern', 'interactable': True}
+            },
+            'bedroom': {
+                'album_collection': {'name': 'album collection', 'description': 'Colorful K-pop albums stacked high', 'interactable': True},
+                'photocards': {'name': 'photocards', 'description': 'Collectible K-pop idol photocards scattered on the desk', 'interactable': True},
+                'phone': {'name': 'phone', 'description': 'A smartphone with K-pop wallpaper', 'interactable': True},
+                'mirror': {'name': 'mirror', 'description': 'A mirror with idol photos tucked around the edges', 'interactable': True},
+                'led_lights': {'name': 'led lights', 'description': 'Colorful LED strip lights creating ambiance', 'interactable': True}
+            },
+            'study': {
+                'grammar_books': {'name': 'grammar books', 'description': 'Thick Korean grammar textbooks with bookmarks', 'interactable': True},
+                'thesis_papers': {'name': 'thesis papers', 'description': 'Academic papers about Korean linguistics', 'interactable': True},
+                'certificates': {'name': 'certificates', 'description': 'Korean language proficiency certificates on the wall', 'interactable': True},
+                'coffee_mug': {'name': 'coffee mug', 'description': 'A mug with Korean university logo', 'interactable': True},
+                'laptop': {'name': 'laptop', 'description': 'A laptop with Korean language learning software', 'interactable': True}
+            },
+            'classroom': {
+                'whiteboard': {'name': 'whiteboard', 'description': 'A whiteboard covered in Korean conjugation examples', 'interactable': True},
+                'textbooks': {'name': 'textbooks', 'description': 'Korean language textbooks for different levels', 'interactable': True},
+                'coffee_thermos': {'name': 'coffee thermos', 'description': 'A large thermos keeping coffee warm for long teaching sessions', 'interactable': True},
+                'grade_sheets': {'name': 'grade sheets', 'description': 'Student assessment papers with red ink corrections', 'interactable': True},
+                'korean_flag': {'name': 'korean flag', 'description': 'A small Korean flag on the desk', 'interactable': True}
+            }
+        }
+        
+        # Learning objectives for each room (3 per room)
+        self.room_objectives = {
+            'kitchen': {
+                'entrance_etiquette': {'completed': False, 'description': 'Learn proper entrance etiquette by examining shoes'},
+                'family_honorifics': {'completed': False, 'description': 'Master family honorifics through grandmother story'},
+                'cooking_language': {'completed': False, 'description': 'Practice polite cooking requests with Ahjumma'}
+            },
+            'garden': {
+                'poetry_appreciation': {'completed': False, 'description': 'Listen to classical Korean poetry reading'},
+                'proverb_wisdom': {'completed': False, 'description': 'Understand traditional Korean proverb about bamboo'},
+                'cultural_sharing': {'completed': False, 'description': 'Share makgeolli and learn drinking culture'}
+            },
+            'bedroom': {
+                'lyrics_translation': {'completed': False, 'description': 'Decode K-pop lyrics with Unni'},
+                'modern_slang': {'completed': False, 'description': 'Learn trendy Korean expressions'},
+                'aegyo_practice': {'completed': False, 'description': 'Practice cute Korean expressions (aegyo)'}
+            },
+            'study': {
+                'grammar_mastery': {'completed': False, 'description': 'Survive complex grammar explanations'},
+                'academic_korean': {'completed': False, 'description': 'Learn formal academic Korean vocabulary'},
+                'conjugation_challenge': {'completed': False, 'description': 'Master verb conjugation patterns'}
+            },
+            'classroom': {
+                'practical_conversation': {'completed': False, 'description': 'Practice everyday Korean conversation'},
+                'survival_phrases': {'completed': False, 'description': 'Learn essential survival Korean phrases'},
+                'pronunciation_practice': {'completed': False, 'description': 'Master Korean pronunciation fundamentals'}
+            }
+        }
+        
+        # Player state
+        self.current_room = 'hall'  # Start in hall (central hub)
+        self.discovered_words = set()
+        self.game_running = True
+        self.game_progress = {}  # Track learning objectives and achievements
+        self.player_inventory = set()  # Track objects player has interacted with
+        
+        # Direction symbols for better UI
+        self.direction_symbols = {
+            "north": "↑",
+            "south": "↓", 
+            "east": "→",
+            "west": "←",
+            "up": "⤴",
+            "down": "⤵",
+            "northeast": "↗",
+            "northwest": "↖",
+            "southeast": "↘",
+            "southwest": "↙",
+        }
+    
+    def clear_screen(self):
+        """Clear the terminal screen."""
+        os.system("cls" if os.name == "nt" else "clear")
+    
+    def display_korean_word(self, korean_word, include_practice=False):
+        """Format and display a Korean vocabulary word with additional information."""
+        print("\n+----------- New Korean Word -----------+")
+        print(f"|  {Colors.BOLD}{korean_word.get('hangul', korean_word.get('korean', 'Unknown'))}{Colors.RESET}")
+
+        if "romanization" in korean_word:
+            print(f"|  Pronunciation: {korean_word['romanization']}")
+
+        print(f"|  Meaning: {korean_word.get('meaning', 'Unknown meaning')}")
+
+        if "usage_example" in korean_word:
+            print(f"|  Example: {korean_word['usage_example']}")
+
+        print("+---------------------------------------+")
+        hangul = korean_word.get('hangul', korean_word.get('korean', ''))
+        if hangul:
+            self.discovered_words.add(hangul)
+
+        if include_practice:
+            print(
+                f"\n{Colors.YELLOW}Practice saying: {Colors.BOLD}{hangul}{Colors.RESET} ({korean_word.get('meaning', '')}){Colors.RESET}"
+            )
+    
+    def display_room(self):
+        """Display the current room information with improved visual formatting."""
+        if self.current_room not in self.room_mapping:
+            print(f"Error: Room '{self.current_room}' not found!")
+            return
+
+        self.clear_screen()
+
+        # Title banner with room name
+        room_info = self._get_room_info()
+        title = f" {room_info['display_name']} "
+        padding = "═" * ((60 - len(title)) // 2)
+        print(f"\n{Colors.BRIGHT_CYAN}{padding}{title}{padding}{Colors.RESET}")
+
+        # Room description
+        print(f"\n{room_info['description']}\n")
+
+        # Create a visually distinct section for navigation
+        print(
+            f"\n{Colors.BRIGHT_BLUE}╔════════ NAVIGATION ════════╗{Colors.RESET}"
+        )
+
+        # Format exits with direction symbols and colors
+        exits = self._get_room_exits()
+        for direction, destination in exits.items():
+            symbol = self.direction_symbols.get(direction, "*")
+            dest_info = self._get_room_info(destination)
+            print(
+                f"{Colors.BRIGHT_BLUE}║ {Colors.RESET}{Colors.GREEN}{symbol} {direction}{Colors.RESET} -> {dest_info['display_name']}"
+            )
+
+        print(
+            f"{Colors.BRIGHT_BLUE}╚═══════════════════════════╝{Colors.RESET}"
+        )
+
+        # Show available actions in this room for clearer gameplay
+        print(
+            f"\n{Colors.BRIGHT_GREEN}╔════════ ACTIONS ═══════════╗{Colors.RESET}"
+        )
+
+        # Show NPC in the room
+        agent_name = self.room_mapping[self.current_room]
+        npc_info = self._get_npc_info(agent_name)
+        print(
+            f"{Colors.BRIGHT_GREEN}║{Colors.RESET} {Colors.BRIGHT_MAGENTA}Character you can talk to:{Colors.RESET}"
+        )
+        print(
+            f"{Colors.BRIGHT_GREEN}║{Colors.RESET}  {Colors.MAGENTA}• {npc_info['name']}{Colors.RESET}"
+        )
+
+        print(
+            f"{Colors.BRIGHT_GREEN}╚═══════════════════════════╝{Colors.RESET}"
+        )
+
+        # Show vocabulary learning prompt
+        vocab_count = len(self.discovered_words)
+        print(
+            f"\n{Colors.YELLOW}You've learned {vocab_count} Korean words so far.{Colors.RESET}"
+        )
+        print(
+            f"{Colors.YELLOW}Talk to family members to learn more Korean!{Colors.RESET}"
+        )
+
+        # Show command prompt with styling
+        print(
+            f"\n{Colors.BRIGHT_GREEN}┌─ What would you like to do? (type 'help' for commands){Colors.RESET}"
+        )
+        print(f"{Colors.BRIGHT_GREEN}└─╼{Colors.RESET} ", end="")
+    
+    def talk_to_npc(self, user_message: str) -> str:
+        """
+        Talk to the NPC in the current room using their single-agent crew.
+        """
+        if self.current_room not in self.room_mapping:
+            return f"No one is available in the {self.current_room}."
+        
+        agent_name = self.room_mapping[self.current_room]
+        
+        if agent_name not in self.agent_crews:
+            return f"{agent_name} is not available right now."
+        
+        # Get NPC info for display
+        npc_info = self._get_npc_info(agent_name)
+        
+        # Only print in CLI mode, skip in web mode to avoid encoding issues
+        if not self.web_mode:
+            print(f"\n{Colors.BRIGHT_CYAN}Talking to {npc_info['name']}...{Colors.RESET}")
+        
+        try:
+            # Use the single-agent crew to get response
+            crew = self.agent_crews[agent_name]
+            result = crew.kickoff(inputs={'query': user_message})
+            
+            response = result.raw if hasattr(result, 'raw') else str(result)
+            
+            # Handle encoding issues more gracefully
+            try:
+                # Try to ensure proper UTF-8 encoding without terminal output
+                if isinstance(response, bytes):
+                    clean_response = response.decode('utf-8', errors='replace')
+                elif isinstance(response, str):
+                    # Re-encode to handle any problematic characters 
+                    clean_response = response.encode('utf-8', errors='replace').decode('utf-8', errors='replace')
+                else:
+                    clean_response = str(response)
+                
+                # Clean up any null bytes or problematic characters
+                clean_response = clean_response.replace('\x00', '').strip()
+                
+                # If response is empty or problematic, provide fallback
+                if not clean_response or len(clean_response.strip()) == 0:
+                    clean_response = f"Hello! I'm {npc_info['name']}. How can I help you learn Korean today?"
+                    
+            except Exception as encoding_error:
+                # Fallback for encoding issues
+                clean_response = f"Hello! I'm {npc_info['name']}. I'm here to help you learn Korean! (Having some encoding issues, but I can still chat!)"
+            
+            # For web interface, just return the response without terminal formatting
+            # Note: Vocabulary teaching is now handled only through object examination
+            # Chat responses focus on natural conversation with inline Korean teaching
+            
+            return clean_response
+            
+        except Exception as e:
+            error_msg = str(e)
+            
+            # Handle specific encoding errors gracefully
+            if any(term in error_msg for term in ['charmap', 'codec', 'encode', 'decode']):
+                fallback_response = f"Hello! I'm {npc_info['name']} and I'm here to help you learn Korean! I'm having some technical difficulties with Korean character display, but I can still teach you Korean language and culture in English."
+                return fallback_response
+            else:
+                return f"Sorry, I'm having technical difficulties right now. Please try again! ({error_msg})"
+    
+    async def talk_to_npc_async(self, user_message: str) -> str:
+        """
+        Async version of talk_to_npc for better performance.
+        """
+        if self.current_room not in self.room_mapping:
+            return f"No one is available in the {self.current_room}."
+        
+        agent_name = self.room_mapping[self.current_room]
+        
+        if agent_name not in self.agent_crews:
+            return f"{agent_name} is not available right now."
+        
+        try:
+            # Use async kickoff for better performance
+            crew = self.agent_crews[agent_name]
+            result = await crew.kickoff_async(inputs={'query': user_message})
+            
+            return result.raw if hasattr(result, 'raw') else str(result)
+            
+        except Exception as e:
+            return f"{agent_name} couldn't respond: {str(e)}"
+    
+    def go_to_room(self, room_name: str) -> str:
+        """
+        Move to a different room in the Korean house.
+        """
+        room_name = room_name.lower().strip()
+        
+        if room_name in self.room_mapping:
+            old_room = self.current_room
+            self.current_room = room_name
+            
+            # Display will refresh automatically in main loop
+            return f"{Colors.GREEN}You moved from {old_room} to {room_name}.{Colors.RESET}"
+        else:
+            available_rooms = ", ".join(self.room_mapping.keys())
+            return f"Unknown room '{room_name}'. Available rooms: {available_rooms}"
+    
+    def look_around(self) -> str:
+        """
+        Look around the current room and get description with objects.
+        """
+        room_info = self._get_room_info()
+        description = room_info['description']
+        
+        # Add objects in room
+        objects = self.room_objects.get(self.current_room, {})
+        if objects:
+            object_list = [obj['name'] for obj in objects.values()]
+            object_str = ", ".join(object_list)
+            description += f"\n\nYou can see: {object_str}\nTry 'examine <object>' to interact with them."
+        
+        # Add NPC information if present
+        agent_name = self.room_mapping.get(self.current_room)
+        if agent_name:
+            npc_info = self._get_npc_info(agent_name)
+            description += f"\n\n{npc_info['name']} is here. {npc_info['description']}"
+        
+        return description
+    
+    def _get_room_info(self, room_name=None):
+        """Get room information including display name and description."""
+        if room_name is None:
+            room_name = self.current_room
+            
+        room_data = {
+            'hall': {
+                'display_name': 'Family Hall (daecheong)',
+                'description': "The central gathering space of the Korean house. A large family portrait dominates one wall, and shoes are neatly arranged by the entrance. Traditional furniture and modern touches blend harmoniously."
+            },
+            'kitchen': {
+                'display_name': 'Korean Kitchen (bueok)',
+                'description': "Warm and bustling with the smell of kimchi-jjigae. Traditional ceramic bowls and chopsticks are neatly arranged. Steam rises from bubbling pots on the stove."
+            },
+            'garden': {
+                'display_name': 'Traditional Garden (jeongwon)', 
+                'description': "A peaceful space with stone paths, bamboo, and a small pavilion for contemplation. Cherry blossoms flutter in the gentle breeze."
+            },
+            'bedroom': {
+                'display_name': 'Modern Bedroom (chimsil)',
+                'description': "Colorful K-pop posters cover the walls, with albums and photocards scattered on the desk. LED lights create a vibrant atmosphere."
+            },
+            'study': {
+                'display_name': 'Academic Study (seojae)',
+                'description': "Shelves lined with Korean grammar books, linguistic journals, and classical literature reach toward the ceiling. A desk lamp illuminates open manuscripts."
+            },
+            'classroom': {
+                'display_name': 'Hagwon Classroom (gyosil)',
+                'description': "Whiteboards covered in Korean characters line the walls. Desks are arranged in rows, and coffee cups are scattered everywhere."
+            }
+        }
+        
+        return room_data.get(room_name, {
+            'display_name': room_name.title(),
+            'description': f"You are in the {room_name}."
+        })
+    
+    def examine_object(self, object_name: str) -> str:
+        """
+        Examine an object in the current room and trigger agent interaction if applicable.
+        """
+        objects = self.room_objects.get(self.current_room, {})
+        
+        # Find object by name (case insensitive, exact match for key or partial match for name)
+        target_object = None
+        object_key = None
+        
+        # First try exact key match
+        for obj_key, obj_data in objects.items():
+            if object_name.lower().replace(' ', '_') == obj_key or object_name.lower() == obj_key:
+                target_object = obj_data
+                object_key = obj_key
+                break
+        
+        # If no exact match, try partial match on display name
+        if not target_object:
+            for obj_key, obj_data in objects.items():
+                if object_name.lower() in obj_data['name'].lower():
+                    target_object = obj_data
+                    object_key = obj_key
+                    break
+        
+        if not target_object:
+            available_objects = [obj['name'] for obj in objects.values()]
+            if available_objects:
+                return f"I don't see '{object_name}' here. Available objects: {', '.join(available_objects)}"
+            else:
+                return "There's nothing to examine in this room."
+        
+        # Mark object as examined
+        self.player_inventory.add(target_object['name'])
+        
+        # Trigger special interactions based on object and room
+        agent_name = self.room_mapping.get(self.current_room)
+        if target_object.get('interactable', False):
+            description = self._trigger_object_interaction(target_object['name'], agent_name)
+        else:
+            description = target_object['description']
+        
+        return description
+    
+    def _trigger_object_interaction(self, object_name: str, agent_name: str) -> str:
+        """
+        Trigger special agent responses for object interactions.
+        """
+        # Define object interaction triggers
+        object_triggers = {
+            'kitchen': {
+                'shoes': "You examine the shoes at the entrance. Should they be removed before entering?",
+                'family_photo': "An old family photo showing grandmother and grandfather in traditional hanbok.",
+                'kimchi_pot': "A traditional onggi pot used for fermenting kimchi. It smells deliciously sour!",
+                'apron': "Grandmother's floral apron, worn from years of cooking for the family."
+            },
+            'garden': {
+                'stone_bench': "A weathered stone bench where grandfather sits to read poetry.",
+                'poetry_scroll': "An ancient scroll with beautiful calligraphy - classical Korean poetry.",
+                'makgeolli_bottle': "Traditional rice wine that grandfather enjoys while sharing stories.",
+                'bamboo': "Tall bamboo stalks that bend but don't break - a symbol of resilience."
+            },
+            'bedroom': {
+                'album_collection': "Stacks of colorful K-pop albums from various idol groups.",
+                'photocards': "Collectible photocards of K-pop idols, carefully organized.",
+                'phone': "A smartphone with the latest K-pop music and social media apps.",
+                'mirror': "A mirror surrounded by photos of favorite K-pop idols."
+            },
+            'study': {
+                'grammar_books': "Thick Korean grammar textbooks with detailed explanations and examples.",
+                'thesis_papers': "Academic papers about Korean linguistics and language acquisition.",
+                'certificates': "Korean language proficiency certificates proudly displayed.",
+                'coffee_mug': "A coffee mug that's seen many late-night study sessions."
+            },
+            'classroom': {
+                'whiteboard': "A whiteboard covered with Korean verb conjugations and grammar rules.",
+                'textbooks': "Korean language textbooks for different proficiency levels.",
+                'coffee_thermos': "A large thermos keeping coffee warm during long teaching sessions.",
+                'grade_sheets': "Student papers with red corrections and encouraging notes."
+            },
+            'hall': {
+                'family_portrait': "A beautiful family portrait showing three generations together in harmony.",
+                'shoes': "Various shoes neatly arranged - a sign of Korean entrance etiquette.",
+                'guest_slippers': "Clean guest slippers waiting for visitors to feel at home.",
+                'welcome_mat': "A mat with Korean characters: 환영합니다 (Welcome)."
+            }
+        }
+        
+        room_triggers = object_triggers.get(self.current_room, {})
+        # Try both space and underscore versions of object name
+        trigger_key = object_name.replace(' ', '_')
+        base_description = room_triggers.get(trigger_key, room_triggers.get(object_name, ""))
+        
+        # Add enhanced learning context and vocabulary
+        enhanced_description = base_description
+        if agent_name:
+            npc_info = self._get_npc_info(agent_name)
+            agent_response = self._get_agent_response_for_object(object_name, agent_name)
+            if agent_response:
+                enhanced_description += f"\n\n💬 {npc_info['name']}: {agent_response}"
+                
+            # Add vocabulary based on object
+            vocab_word = self._get_object_vocabulary(object_name, self.current_room)
+            if vocab_word:
+                enhanced_description += f"\n\n📚 New Korean Word: {vocab_word['korean']} ({vocab_word['meaning']})"
+                self.discovered_words.add(vocab_word['korean'])
+        
+        return enhanced_description
+    
+    def _get_agent_response_for_object(self, object_name: str, agent_name: str) -> str:
+        """Get culturally appropriate agent responses for object interactions."""
+        agent_responses = {
+            'ahjumma_gpt': {
+                'shoes': "아이고! You should remove your shoes before entering. This is basic Korean manner. 신발을 벗으세요!",
+                'family_photo': "This is my dear mother-in-law, 할머니. She taught me everything about proper Korean cooking and respect.",
+                'kimchi_pot': "This onggi has been in our family for generations. Real kimchi needs proper fermentation - it's our Korean soul food!",
+                'apron': "This old apron has served me well. A good Korean woman always keeps her family well-fed."
+            },
+            'ahjussi_gpt': {
+                'stone_bench': "I carved this bench myself 30 years ago. It's where I contemplate life and read classical poetry.",
+                'poetry_scroll': "Ah, this is Yun Dong-ju's poetry. He captured the Korean spirit during dark times. Beautiful, isn't it?",
+                'makgeolli_bottle': "Traditional rice wine connects us to our ancestors. Let me share a 속담: '술은 인생의 벗' - alcohol is life's companion.",
+                'bamboo': "Bamboo bends but never breaks. This teaches us Korean resilience - we survive all hardships."
+            },
+            'unni_gpt': {
+                'album_collection': "OMG these are limited editions! BTS, BLACKPINK, aespa - I have them all! Want me to teach you the lyrics?",
+                'photocards': "These photocards are so rare! Trading them is like a whole culture. It's how we show our 덕질 dedication!",
+                'phone': "I'm always watching music shows and learning new choreography. Want to try some aegyo? 사랑해요~",
+                'mirror': "This is where I practice my idol poses! Korean beauty standards are so important in K-pop culture."
+            },
+            'oppa_gpt': {
+                'grammar_books': "Korean grammar is fascinating - the honorific system reflects our entire social structure. Let me explain 존댓말.",
+                'thesis_papers': "I'm researching Korean language evolution. Did you know our writing system 한글 is scientifically perfect?",
+                'certificates': "These represent years of Korean study. Language is the key to understanding any culture deeply.",
+                'coffee_mug': "Coffee fuels my academic work. In Korea, we say 화이팅! for encouragement during tough times."
+            },
+            'seonsaengnim_gpt': {
+                'whiteboard': "This board has taught thousands of students Korean. Grammar is important, but communication is the goal!",
+                'textbooks': "I've written some of these books myself. Learning Korean opens doors to understanding our beautiful culture.",
+                'coffee_thermos': "Teaching Korean all day requires lots of caffeine! Good teachers need energy to help students succeed.",
+                'grade_sheets': "Every red mark here is meant to help students improve. Mistakes are part of learning Korean!"
+            }
+        }
+        
+        # Try both space and underscore versions  
+        trigger_key = object_name.replace(' ', '_')
+        agent_dict = agent_responses.get(agent_name, {})
+        return agent_dict.get(trigger_key, agent_dict.get(object_name, ""))
+    
+    def _get_object_vocabulary(self, object_name: str, room: str) -> dict:
+        """Get Korean vocabulary associated with objects."""
+        vocabulary_map = {
+            'shoes': {'korean': '신발', 'meaning': 'shoes'},
+            'family_photo': {'korean': '가족사진', 'meaning': 'family photo'},
+            'kimchi_pot': {'korean': '김치', 'meaning': 'kimchi'},
+            'apron': {'korean': '앞치마', 'meaning': 'apron'},
+            'stone_bench': {'korean': '돌벤치', 'meaning': 'stone bench'},
+            'poetry_scroll': {'korean': '시', 'meaning': 'poetry'},
+            'makgeolli_bottle': {'korean': '막걸리', 'meaning': 'traditional rice wine'},
+            'bamboo': {'korean': '대나무', 'meaning': 'bamboo'},
+            'album_collection': {'korean': '앨범', 'meaning': 'album'},
+            'photocards': {'korean': '포토카드', 'meaning': 'photocard'},
+            'phone': {'korean': '휴대폰', 'meaning': 'mobile phone'},
+            'mirror': {'korean': '거울', 'meaning': 'mirror'},
+            'grammar_books': {'korean': '문법책', 'meaning': 'grammar book'},
+            'thesis_papers': {'korean': '논문', 'meaning': 'thesis/paper'},
+            'certificates': {'korean': '자격증', 'meaning': 'certificate'},
+            'coffee_mug': {'korean': '커피잔', 'meaning': 'coffee cup'},
+            'whiteboard': {'korean': '화이트보드', 'meaning': 'whiteboard'},
+            'textbooks': {'korean': '교과서', 'meaning': 'textbook'},
+            'coffee_thermos': {'korean': '보온병', 'meaning': 'thermos'},
+            'grade_sheets': {'korean': '성적표', 'meaning': 'grade sheet'}
+        }
+        
+        # Try both space and underscore versions
+        trigger_key = object_name.replace(' ', '_')
+        return vocabulary_map.get(trigger_key, vocabulary_map.get(object_name, None))
+    
+    def take_object(self, object_name: str) -> str:
+        """
+        Attempt to take an object (most objects can't be taken, but gives cultural context).
+        """
+        objects = self.room_objects.get(self.current_room, {})
+        
+        # Find object
+        target_object = None
+        for obj_key, obj_data in objects.items():
+            if object_name.lower() in obj_data['name'].lower():
+                target_object = obj_data
+                break
+        
+        if not target_object:
+            return f"I don't see '{object_name}' here."
+        
+        # Most objects can't be taken, but provide cultural context
+        cultural_responses = {
+            'shoes': "In Korean culture, shoes should be left at the entrance. You can't take them to other rooms!",
+            'family_photo': "Family photos are treasured keepsakes that stay in their place of honor.",
+            'kimchi_pot': "The kimchi pot is too precious and heavy to move - it's part of the kitchen!",
+            'poetry_scroll': "Ancient scrolls are too valuable and fragile to carry around.",
+            'albums': "These K-pop albums are carefully organized - better not disturb the collection!",
+            'textbooks': "These study materials belong here for everyone to use.",
+            'coffee_mug': "That's someone else's personal mug - better leave it where it is!"
+        }
+        
+        # Check for partial matches
+        for item, response in cultural_responses.items():
+            if item in object_name.lower():
+                return response
+        
+        return f"You can't take the {object_name}. It belongs here as part of the room."
+    
+    def _get_room_exits(self):
+        """Get available exits from current room with hall as central hub."""
+        # Define the house layout with hall as central hub
+        exits_map = {
+            'hall': {'north': 'garden', 'south': 'classroom', 'east': 'study', 'west': 'kitchen'},
+            'kitchen': {'east': 'hall', 'north': 'bedroom'},
+            'garden': {'south': 'hall', 'east': 'bedroom'},
+            'bedroom': {'south': 'study', 'west': 'garden', 'southwest': 'kitchen'},
+            'study': {'west': 'hall', 'north': 'bedroom'},
+            'classroom': {'north': 'hall'}
+        }
+        
+        return exits_map.get(self.current_room, {})
+    
+    def _get_npc_info(self, agent_name: str) -> dict:
+        """
+        Get information about the NPC in the room.
+        """
+        npc_data = {
+            'ahjumma_gpt': {
+                'name': 'Kim Soon-ja (Ahjumma)',
+                'description': "She sits here wearing her floral apron and hair rollers, ready to teach you proper Korean honorifics - whether you want to learn or not!"
+            },
+            'ahjussi_gpt': {
+                'name': 'Park Chul-min (Ahjussi)', 
+                'description': "He relaxes here with his reading glasses and classical poetry book, ready to share ancient Korean wisdom and cultural stories."
+            },
+            'unni_gpt': {
+                'name': 'Lee Min-ji (Unni)',
+                'description': "She's here surrounded by K-pop albums and merchandise, excited to teach you Korean through the latest idol songs and trends!"
+            },
+            'oppa_gpt': {
+                'name': 'Jung Jae-hyun (Oppa)',
+                'description': "He studies here with thick grammar books and linguistic papers, eager to show off his superior knowledge of Korean grammar."
+            },
+            'seonsaengnim_gpt': {
+                'name': 'Choi Soo-jin (Seonsaengnim)',
+                'description': "She sits here with coffee and red pens, looking exhausted but ready to provide practical Korean lessons despite her complaints."
+            }
+        }
+        
+        return npc_data.get(agent_name, {
+            'name': 'Someone',
+            'description': 'Someone is here to help you learn Korean.'
+        })
+    
+    def _extract_korean_word_from_response(self, response: str, agent_name: str) -> dict:
+        """Extract or generate a Korean word from the agent's response."""
+        import re
+        import random
+        
+        # First try to extract actual Korean words from the response
+        korean_pattern = r'📚 New Korean Word: ([가-힣]+) \(([^)]+)\) = ([^"\n]+)'
+        match = re.search(korean_pattern, response)
+        
+        if match:
+            hangul, romanization, meaning = match.groups()
+            word_dict = {
+                'hangul': hangul.strip(),
+                'romanization': romanization.strip(), 
+                'meaning': meaning.strip()
+            }
+            self.discovered_words.add(word_dict['hangul'])
+            return word_dict
+        
+        # Fallback to curated word pools (but avoid repeats)
+        sample_words = {
+            'ahjumma_gpt': [
+                {'hangul': '존댓말', 'meaning': 'honorific speech', 'romanization': 'jondaetmal'},
+                {'hangul': '할머니', 'meaning': 'grandmother', 'romanization': 'halmeoni'},
+                {'hangul': '부엌', 'meaning': 'kitchen', 'romanization': 'bueok'},
+                {'hangul': '정중하게', 'meaning': 'politely', 'romanization': 'jeongjunghage'},
+                {'hangul': '예의', 'meaning': 'manners/etiquette', 'romanization': 'yeui'}
+            ],
+            'ahjussi_gpt': [
+                {'hangul': '속담', 'meaning': 'proverb', 'romanization': 'sokdam'},
+                {'hangul': '지혜', 'meaning': 'wisdom', 'romanization': 'jihye'},
+                {'hangul': '전통', 'meaning': 'tradition', 'romanization': 'jeontong'},
+                {'hangul': '문화', 'meaning': 'culture', 'romanization': 'munhwa'},
+                {'hangul': '역사', 'meaning': 'history', 'romanization': 'yeoksa'}
+            ],
+            'unni_gpt': [
+                {'hangul': '대박', 'meaning': 'awesome/amazing', 'romanization': 'daebak'},
+                {'hangul': '아이돌', 'meaning': 'idol', 'romanization': 'aidol'},
+                {'hangul': '노래', 'meaning': 'song', 'romanization': 'norae'},
+                {'hangul': '춤', 'meaning': 'dance', 'romanization': 'chum'},
+                {'hangul': '귀여워', 'meaning': 'cute', 'romanization': 'gwiyeowo'}
+            ],
+            'oppa_gpt': [
+                {'hangul': '문법', 'meaning': 'grammar', 'romanization': 'munbeop'},
+                {'hangul': '동사', 'meaning': 'verb', 'romanization': 'dongsa'},
+                {'hangul': '활용', 'meaning': 'conjugation', 'romanization': 'hwalyong'},
+                {'hangul': '언어학', 'meaning': 'linguistics', 'romanization': 'eoneohak'},
+                {'hangul': '발음', 'meaning': 'pronunciation', 'romanization': 'bareum'}
+            ],
+            'seonsaengnim_gpt': [
+                {'hangul': '공부', 'meaning': 'study', 'romanization': 'gongbu'},
+                {'hangul': '숙제', 'meaning': 'homework', 'romanization': 'sukje'},
+                {'hangul': '시험', 'meaning': 'test/exam', 'romanization': 'siheom'},
+                {'hangul': '학습', 'meaning': 'learning', 'romanization': 'hakseup'},
+                {'hangul': '연습', 'meaning': 'practice', 'romanization': 'yeonseup'}
+            ]
+        }
+        
+        words = sample_words.get(agent_name, [])
+        if words:
+            # Filter out words already discovered to avoid repeats
+            new_words = [w for w in words if w['hangul'] not in self.discovered_words]
+            if new_words:
+                chosen_word = random.choice(new_words)
+                self.discovered_words.add(chosen_word['hangul'])
+                return chosen_word
+            else:
+                # If all words from this agent have been learned, occasionally still show one
+                if random.random() < 0.3:  # 30% chance to repeat a word
+                    return random.choice(words)
+        
+        return None
+    
+    def show_help(self):
+        """Display the help menu with colorful formatting."""
+        self.clear_screen()
+
+        # Title with decorative border
+        print(
+            f"\n{Colors.BRIGHT_CYAN}╔═══════════════ 도움말 (HELP) ═══════════════╗{Colors.RESET}"
+        )
+
+        # Command section
+        print(
+            f"{Colors.BRIGHT_CYAN}║{Colors.RESET} {Colors.BRIGHT_GREEN}Available Commands:{Colors.RESET}"
+        )
+
+        commands = [
+            ("look", "Look around the current room"),
+            (
+                f"examine {Colors.YELLOW}[object]{Colors.RESET}",
+                "Examine an object in the room",
+            ),
+            (
+                f"take {Colors.YELLOW}[object]{Colors.RESET}",
+                "Attempt to take an object (usually provides cultural context)",
+            ),
+            (
+                f"go {Colors.YELLOW}[room]{Colors.RESET}",
+                "Move to a different room (hall, kitchen, garden, bedroom, study, classroom)",
+            ),
+            (
+                f"talk {Colors.YELLOW}[message]{Colors.RESET}",
+                "Talk to the Korean family member in this room",
+            ),
+            ("rooms", "List all available rooms"),
+            ("help", "Show this help menu"),
+            ("quit/exit", "Leave the game"),
+        ]
+
+        for cmd, desc in commands:
+            print(
+                f"{Colors.BRIGHT_CYAN}║{Colors.RESET} {Colors.BRIGHT_WHITE}{cmd:<25}{Colors.RESET} {desc}"
+            )
+
+        # Korean learning section
+        print(
+            f"{Colors.BRIGHT_CYAN}╠═════════════ KOREAN LEARNING ════════════════╣{Colors.RESET}"
+        )
+        print(
+            f"{Colors.BRIGHT_CYAN}║{Colors.RESET} Each conversation teaches you a new Korean word."
+        )
+        print(
+            f"{Colors.BRIGHT_CYAN}║{Colors.RESET} Words are highlighted in {Colors.YELLOW}{Colors.BOLD}yellow{Colors.RESET} and added to your vocabulary."
+        )
+
+        # Progress bar for vocabulary
+        learned_count = len(self.discovered_words)
+        total_possible = 15  # Rough estimate
+        progress_percent = (
+            int((learned_count / total_possible) * 100) if total_possible > 0 else 0
+        )
+
+        bar_length = 30
+        filled_length = int(bar_length * learned_count // total_possible)
+        bar = f"{Colors.GREEN}{'█' * filled_length}{Colors.BRIGHT_BLACK}{'░' * (bar_length - filled_length)}{Colors.RESET}"
+
+        print(
+            f"{Colors.BRIGHT_CYAN}║{Colors.RESET} Words learned: {learned_count}"
+        )
+        print(f"{Colors.BRIGHT_CYAN}║{Colors.RESET} {bar} {progress_percent}%")
+
+        # Game objective section
+        print(
+            f"{Colors.BRIGHT_CYAN}╠═════════════ GAME OBJECTIVE ════════════════╣{Colors.RESET}"
+        )
+        print(f"{Colors.BRIGHT_CYAN}║{Colors.RESET} Explore the Korean family house and learn Korean!")
+        print(f"{Colors.BRIGHT_CYAN}║{Colors.RESET} Talk to each family member to discover their personalities")
+        print(f"{Colors.BRIGHT_CYAN}║{Colors.RESET} and learn Korean words through authentic conversations.")
+        print(
+            f"{Colors.BRIGHT_CYAN}╚═══════════════════════════════════════════════╝{Colors.RESET}"
+        )
+
+        input(f"\n{Colors.GREEN}Press Enter to continue...{Colors.RESET}")
+        
+    def show_intro(self):
+        """Display the game introduction."""
+        self.clear_screen()
+        print("\n" + "=" * 60)
+        print("        KOREAN FAMILY HOUSE - LANGUAGE ADVENTURE")
+        print("=" * 60)
+        print("\nWelcome to a Korean family house where you'll learn Korean!")
+        print("Explore themed rooms and talk to Korean family members.")
+        print("Each conversation will teach you new Korean words and culture.")
+        print("\nYour Korean Family:")
+        print("  - Ahjumma (Kitchen): Honorifics and formality")
+        print("  - Ahjussi (Garden): Traditional culture and wisdom")
+        print("  - Unni (Bedroom): K-pop and modern Korean")
+        print("  - Oppa (Study): Grammar and linguistics")
+        print("  - Seonsaengnim (Classroom): General Korean lessons")
+        print("\nType 'help' anytime to see available commands.")
+        print("\nPress Enter to begin your Korean learning adventure...")
+        input()
+    
+    def list_rooms(self):
+        """List all available rooms with their themes."""
+        self.clear_screen()
+        
+        print(f"\n{Colors.BRIGHT_YELLOW}╔══════════ KOREAN FAMILY HOUSE ROOMS ══════════╗{Colors.RESET}")
+        
+        for room_name, agent_name in self.room_mapping.items():
+            room_info = self._get_room_info(room_name)
+            npc_info = self._get_npc_info(agent_name)
+            current = f" {Colors.BRIGHT_GREEN}← YOU ARE HERE{Colors.RESET}" if room_name == self.current_room else ""
+            
+            print(f"{Colors.BRIGHT_YELLOW}║{Colors.RESET} {room_info['display_name']}")
+            print(f"{Colors.BRIGHT_YELLOW}║{Colors.RESET}   Character: {npc_info['name']}{current}")
+            print(f"{Colors.BRIGHT_YELLOW}║{Colors.RESET}")
+        
+        print(f"{Colors.BRIGHT_YELLOW}╚═══════════════════════════════════════════════╝{Colors.RESET}")
+        input(f"\n{Colors.GREEN}Press Enter to continue...{Colors.RESET}")
+    
+    def handle_command(self, command):
+        """Process the player's command."""
+        parts = command.lower().split()
+
+        if not parts:
+            return
+
+        action = parts[0]
+
+        # Basic directional movement shortcuts
+        if action in ["north", "south", "east", "west", "up", "down"]:
+            self.move_player(action)
+            return
+
+        # Standard commands
+        if action == "look":
+            # Room will redisplay automatically in main loop
+            return
+
+        elif action == "go" and len(parts) > 1:
+            room_name = parts[1]
+            result = self.go_to_room(room_name)
+            if "moved" not in result:  # Only print if there was an error
+                print(result)
+                time.sleep(1.5)
+
+        elif action == "examine" or action == "look" and len(parts) > 1:
+            if len(parts) > 1:
+                object_name = " ".join(parts[1:])
+                result = self.examine_object(object_name)
+                print(f"\n{result}")
+                input(f"\n{Colors.GREEN}Press Enter to continue...{Colors.RESET}")
+            else:
+                print(f"{Colors.YELLOW}Examine what? Try 'examine <object>'.{Colors.RESET}")
+                time.sleep(1.5)
+        
+        elif action == "take":
+            if len(parts) > 1:
+                object_name = " ".join(parts[1:])
+                result = self.take_object(object_name)
+                print(f"\n{result}")
+                input(f"\n{Colors.GREEN}Press Enter to continue...{Colors.RESET}")
+            else:
+                print(f"{Colors.YELLOW}Take what? Try 'take <object>'.{Colors.RESET}")
+                time.sleep(1.5)
+
+        elif action == "talk":
+            if len(parts) > 1:
+                # User provided a message
+                message = " ".join(parts[1:])
+            else:
+                # Just "talk" - start a conversation
+                message = "Hello!"
+            
+            self.talk_to_npc(message)
+            input(f"\n{Colors.GREEN}Press Enter to continue...{Colors.RESET}")
+
+        elif action == "rooms":
+            self.list_rooms()
+
+        elif action == "help" or action == "?":
+            self.show_help()
+
+        elif action in ["exit", "quit"]:
+            self.game_running = False
+            print(
+                f"{Colors.BRIGHT_GREEN}Thank you for playing! 안녕히 가세요 (Goodbye)!{Colors.RESET}"
+            )
+
+        else:
+            print(f"{Colors.YELLOW}I don't understand '{command}'. Type 'help' for commands.{Colors.RESET}")
+            time.sleep(1.5)
+
+    def move_player(self, direction):
+        """Move the player in the specified direction."""
+        exits = self._get_room_exits()
+
+        if direction in exits:
+            self.current_room = exits[direction]
+        else:
+            available_directions = ", ".join(exits.keys()) if exits else "none"
+            print(f"{Colors.YELLOW}You can't go {direction} from here. Available: {available_directions}{Colors.RESET}")
+            time.sleep(1.5)
+    
+    def run(self):
+        """Main game loop."""
+        self.show_intro()
+
+        while self.game_running:
+            self.display_room()
+            try:
+                command = input()
+                self.handle_command(command)
+            except KeyboardInterrupt:
+                print(f"\n{Colors.BRIGHT_GREEN}Goodbye! 안녕히 가세요!{Colors.RESET}")
+                break
+
+
+def main():
+    """
+    CLI interface for the Korean Learning MUD game.
+    """
+    try:
+        game = KoreanLearningMUD()
+        game.run()
+        
+        # Show final vocabulary learned
+        if game.discovered_words:
+            print(f"\n{Colors.BRIGHT_YELLOW}Korean words you learned:{Colors.RESET}")
+            for word in game.discovered_words:
+                print(f"  - {word}")
+        
+    except KeyboardInterrupt:
+        print(f"\n{Colors.BRIGHT_GREEN}Goodbye! 안녕히 가세요!{Colors.RESET}")
+    except Exception as e:
+        print(f"{Colors.RED}Game error: {e}{Colors.RESET}")
+
+
+    def _check_object_objectives(self, object_name: str) -> str:
+        """
+        Check if examining this object completes any learning objectives.
+        """
+        if self.current_room not in self.room_objectives:
+            return ""
+        
+        # Define which objects complete which objectives
+        object_objective_map = {
+            'kitchen': {
+                'shoes': 'entrance_etiquette',
+                'family_photo': 'family_honorifics'
+            },
+            'garden': {
+                'poetry_scroll': 'poetry_appreciation',
+                'bamboo': 'proverb_wisdom',
+                'makgeolli_bottle': 'cultural_sharing'
+            },
+            'bedroom': {
+                'album_collection': 'lyrics_translation',
+                'photocards': 'modern_slang'
+            },
+            'study': {
+                'grammar_books': 'grammar_mastery',
+                'thesis_papers': 'academic_korean'
+            },
+            'classroom': {
+                'textbooks': 'practical_conversation',
+                'whiteboard': 'pronunciation_practice'
+            }
+        }
+        
+        room_map = object_objective_map.get(self.current_room, {})
+        objective_key = room_map.get(object_name)
+        
+        if objective_key and objective_key in self.room_objectives[self.current_room]:
+            if not self.room_objectives[self.current_room][objective_key]['completed']:
+                self.room_objectives[self.current_room][objective_key]['completed'] = True
+                return self.room_objectives[self.current_room][objective_key]['description']
+        
+        return ""
+    
+    def get_room_progress(self) -> dict:
+        """
+        Get learning progress for current room.
+        """
+        if self.current_room not in self.room_objectives:
+            return {'completed': 0, 'total': 0, 'objectives': []}
+        
+        objectives = self.room_objectives[self.current_room]
+        completed = sum(1 for obj in objectives.values() if obj['completed'])
+        total = len(objectives)
+        
+        return {
+            'completed': completed,
+            'total': total,
+            'objectives': [{
+                'name': key,
+                'description': obj['description'],
+                'completed': obj['completed']
+            } for key, obj in objectives.items()]
+        }
+
+
+if __name__ == "__main__":
+    main()

web_server.py

@@ -0,0 +1,443 @@
+#!/usr/bin/env python
+"""
+FastAPI web server for Korean Learning MUD game.
+Provides REST API endpoints for the HTML frontend.
+"""
+
+import os
+import sys
+import logging
+from typing import Dict, Any, List
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
+from fastapi.responses import HTMLResponse
+from pydantic import BaseModel
+import uvicorn
+
+# Add src to Python path
+sys.path.append(os.path.join(os.path.dirname(__file__), 'src'))
+
+try:
+    from korean_cpc_agents.mud_game import KoreanLearningMUD
+except ImportError as e:
+    print(f"Error importing MUD game: {e}")
+    print("Make sure you're running from the project root directory")
+    sys.exit(1)
+
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+# FastAPI app
+app = FastAPI(title="Korean Learning MUD Game", version="1.0.0")
+
+# CORS middleware for frontend
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Mount static files for assets
+app.mount("/assets", StaticFiles(directory="assets"), name="assets")
+
+# Global game instance
+game_instance = None
+
+# Pydantic models for API
+class CommandRequest(BaseModel):
+    command: str
+
+class TalkRequest(BaseModel):
+    message: str
+
+class GameResponse(BaseModel):
+    success: bool
+    message: str
+    data: Dict[str, Any] = {}
+
+class GameState(BaseModel):
+    current_room: str
+    discovered_words: List[str]
+    game_progress: Dict[str, Any]
+
+@app.on_event("startup")
+async def startup_event():
+    """Initialize the game on server startup"""
+    global game_instance
+    try:
+        logger.info("Initializing Korean Learning MUD game...")
+        game_instance = KoreanLearningMUD(web_mode=True)  # Enable web mode to avoid terminal encoding
+        logger.info("Game initialized successfully!")
+    except Exception as e:
+        logger.error(f"Failed to initialize game: {e}")
+        raise
+
+@app.get("/")
+async def read_root():
+    """Serve the main game HTML page"""
+    try:
+        import os
+        logger.info(f"Current working directory: {os.getcwd()}")
+        logger.info(f"Looking for file: korean_mud_game.html")
+        logger.info(f"File exists: {os.path.exists('korean_mud_game.html')}")
+        
+        with open("korean_mud_game.html", "r", encoding="utf-8") as f:
+            html_content = f.read()
+        logger.info(f"Successfully read {len(html_content)} characters from HTML file")
+        return HTMLResponse(content=html_content)
+    except FileNotFoundError as e:
+        logger.error(f"FileNotFoundError: {e}")
+        return HTMLResponse(content="<h1>Game file not found. Please run the server from the project root.</h1>")
+    except Exception as e:
+        logger.error(f"Unexpected error reading HTML file: {e}")
+        return HTMLResponse(content=f"<h1>Error loading game: {str(e)}</h1>")
+
+@app.get("/api/game/state")
+async def get_game_state() -> GameState:
+    """Get current game state"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        return GameState(
+            current_room=game_instance.current_room,
+            discovered_words=list(game_instance.discovered_words),
+            game_progress=game_instance.game_progress
+        )
+    except Exception as e:
+        logger.error(f"Error getting game state: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+@app.get("/api/game/room-info")
+async def get_room_info() -> GameResponse:
+    """Get current room information"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        room_info = game_instance.look_around()
+        
+        # Get room mapping and NPC info
+        current_room = game_instance.current_room
+        agent_name = game_instance.room_mapping.get(current_room)
+        npc_info = {}
+        
+        if agent_name:
+            npc_info = game_instance._get_npc_info(agent_name)
+        
+        # Get objects in current room
+        room_objects = game_instance.room_objects.get(current_room, {})
+        objects_list = [{"name": obj_data["name"], "description": obj_data["description"]} 
+                       for obj_data in room_objects.values()]
+        
+        return GameResponse(
+            success=True,
+            message=room_info,
+            data={
+                "current_room": current_room,
+                "npc_info": npc_info,
+                "room_mapping": game_instance.room_mapping,
+                "discovered_words": list(game_instance.discovered_words),
+                "objects": objects_list
+            }
+        )
+    except Exception as e:
+        logger.error(f"Error getting room info: {e}")
+        return GameResponse(success=False, message=f"Error: {str(e)}")
+
+@app.post("/api/game/move")
+async def move_to_room(request: CommandRequest) -> GameResponse:
+    """Move to a different room"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        # Extract room name from command (e.g., "go kitchen" -> "kitchen")
+        parts = request.command.strip().split()
+        if len(parts) < 2:
+            return GameResponse(success=False, message="Please specify which room to go to")
+        
+        room_name = parts[1].lower()
+        result = game_instance.go_to_room(room_name)
+        
+        # Get NPC info for the new room
+        current_room = game_instance.current_room
+        agent_name = game_instance.room_mapping.get(current_room)
+        npc_info = {}
+        if agent_name:
+            npc_info = game_instance._get_npc_info(agent_name)
+        
+        return GameResponse(
+            success=True,
+            message=result,
+            data={
+                "current_room": current_room,
+                "discovered_words": list(game_instance.discovered_words),
+                "room_objects": [obj['name'] for obj in game_instance.room_objects.get(current_room, {}).values()],
+                "room_mapping": game_instance.room_mapping,
+                "npc_info": npc_info
+            }
+        )
+    except Exception as e:
+        logger.error(f"Error moving to room: {e}")
+        return GameResponse(success=False, message=f"Error: {str(e)}")
+
+@app.post("/api/game/talk")
+async def talk_to_npc(request: TalkRequest) -> GameResponse:
+    """Talk to the NPC in current room"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        logger.info(f"Player message: {request.message}")
+        response = game_instance.talk_to_npc(request.message)
+        
+        return GameResponse(
+            success=True,
+            message=response,
+            data={
+                "current_room": game_instance.current_room,
+                "discovered_words": list(game_instance.discovered_words),
+                "room_objects": [obj['name'] for obj in game_instance.room_objects.get(game_instance.current_room, {}).values()]
+            }
+        )
+    except Exception as e:
+        logger.error(f"Error talking to NPC: {e}")
+        return GameResponse(success=False, message=f"NPC couldn't respond: {str(e)}")
+
+@app.get("/api/game/rooms")
+async def list_rooms() -> GameResponse:
+    """Get list of available rooms"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        rooms = list(game_instance.room_mapping.keys())
+        return GameResponse(
+            success=True,
+            message="Available rooms",
+            data={"rooms": rooms, "room_mapping": game_instance.room_mapping}
+        )
+    except Exception as e:
+        logger.error(f"Error listing rooms: {e}")
+        return GameResponse(success=False, message=f"Error: {str(e)}")
+
+@app.get("/api/game/help")
+async def get_help() -> GameResponse:
+    """Get help information with proper formatting"""
+    help_text = """🎮 KOREAN LEARNING MUD GAME HELP
+
+📋 BASIC COMMANDS:
+• look / l → Look around your current room
+• examine [object] → Examine an object in detail
+• take [object] → Try to take an object (learn cultural context)
+• go [room] → Move to another room (hall, kitchen, garden, bedroom, study, classroom)  
+• talk [message] → Chat with Korean family member in your room
+• rooms / map → See all available rooms and who's there
+• help / ? → Show this help menu
+
+🚀 QUICK SHORTCUTS:
+• n/s/e/w → Go north/south/east/west
+• Just type what you want to say directly (no "talk" needed!)
+
+🏠 KOREAN FAMILY HOUSE LAYOUT:
+                    🌸 Garden (정원)
+                    👴 Grandpa Park
+                         |
+    🍳 Kitchen ---- 🏠 Hall ---- 📚 Study  
+    👵 Grandma            📖 Brother Jung
+                         |
+                    ✏️ Classroom
+                    👩‍🏫 Teacher Choi
+                         |
+                    🎵 Bedroom
+                    👩 Sister Lee
+
+🎯 GAME OBJECTIVE:
+Learn Korean by talking to different family members! Each has their own personality:
+• 👵 Grandma Kim (Kitchen): Teaches honorifics and formal speech
+• 👴 Grandpa Park (Garden): Shares traditional culture and wisdom
+• 👩 Sister Lee (Bedroom): Teaches K-pop slang and modern Korean
+• 📖 Brother Jung (Study): Grammar expert and linguistic genius  
+• 👩‍🏫 Teacher Choi (Classroom): General Korean lessons and practical phrases
+
+💬 HOW TO PLAY:
+Just type naturally! Say "Hello", "Teach me Korean", "What's your favorite food?"
+Examine objects in each room to learn about Korean culture!
+The game will understand most commands. When in doubt, just talk to the NPCs!
+
+🔍 INTERACTIVE OBJECTS:
+Each room has objects you can examine. Try 'examine shoes' or 'look at family photo'.
+Some objects trigger special conversations with family members!"""
+    
+    return GameResponse(
+        success=True,
+        message=help_text
+    )
+
+@app.post("/api/game/examine")
+async def examine_object(request: CommandRequest) -> GameResponse:
+    """Examine an object in the current room"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        # Extract object name from command
+        parts = request.command.strip().split()
+        if len(parts) < 2:
+            return GameResponse(success=False, message="Please specify which object to examine")
+        
+        object_name = " ".join(parts[1:])
+        result = game_instance.examine_object(object_name)
+        
+        return GameResponse(
+            success=True,
+            message=result,
+            data={
+                "current_room": game_instance.current_room,
+                "discovered_words": list(game_instance.discovered_words),
+                "room_objects": [obj['name'] for obj in game_instance.room_objects.get(game_instance.current_room, {}).values()],
+                "player_inventory": list(game_instance.player_inventory)
+            }
+        )
+    except Exception as e:
+        logger.error(f"Error examining object: {e}")
+        return GameResponse(success=False, message=f"Error: {str(e)}")
+
+@app.post("/api/game/take")
+async def take_object(request: CommandRequest) -> GameResponse:
+    """Try to take an object in the current room"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        # Extract object name from command
+        parts = request.command.strip().split()
+        if len(parts) < 2:
+            return GameResponse(success=False, message="Please specify which object to take")
+        
+        object_name = " ".join(parts[1:])
+        result = game_instance.take_object(object_name)
+        
+        return GameResponse(
+            success=True,
+            message=result,
+            data={
+                "current_room": game_instance.current_room,
+                "discovered_words": list(game_instance.discovered_words),
+                "room_objects": [obj['name'] for obj in game_instance.room_objects.get(game_instance.current_room, {}).values()],
+                "player_inventory": list(game_instance.player_inventory)
+            }
+        )
+    except Exception as e:
+        logger.error(f"Error taking object: {e}")
+        return GameResponse(success=False, message=f"Error: {str(e)}")
+
+@app.post("/api/game/command")
+async def process_command(request: CommandRequest) -> GameResponse:
+    """Process a general game command with flexible parsing"""
+    if not game_instance:
+        raise HTTPException(status_code=500, detail="Game not initialized")
+    
+    try:
+        command = request.command.strip()
+        command_lower = command.lower()
+        
+        # More flexible command parsing
+        if any(cmd in command_lower for cmd in ['look', 'see', 'observe', '보기', 'l']):
+            result = game_instance.look_around()
+            return GameResponse(success=True, message=result)
+            
+        elif any(cmd in command_lower for cmd in ['go', 'move', 'travel', 'enter', '이동']):
+            return await move_to_room(request)
+            
+        elif any(cmd in command_lower for cmd in ['rooms', 'list', 'map', '방목록', 'where']):
+            # Return formatted room list with map
+            rooms_data = await list_rooms()
+            if rooms_data.success:
+                room_list = "\n".join([f"• {room.title()} - {game_instance._get_npc_info(game_instance.room_mapping[room])['name'] if game_instance.room_mapping[room] else 'No NPC'}" for room in rooms_data.data['rooms']])
+                map_text = f"🏠 KOREAN FAMILY HOUSE MAP 🇰🇷\n\n" + \
+                          f"                    🌸 Garden (정원)\n" + \
+                          f"                    👴 Grandpa Park\n" + \
+                          f"                         |\n" + \
+                          f"    🍳 Kitchen ---- 🏠 Hall ---- 📚 Study\n" + \
+                          f"    👵 Grandma Kim              📖 Brother Jung\n" + \
+                          f"                         |\n" + \
+                          f"                    ✏️ Classroom (교실)\n" + \
+                          f"                    👩‍🏫 Teacher Choi\n" + \
+                          f"                         |\n" + \
+                          f"                    🎵 Bedroom (침실)\n" + \
+                          f"                    👩 Sister Lee\n\n" + \
+                          f"🚪 Available Rooms:\n{room_list}\n\nUse 'go [room]' to move around!"
+                return GameResponse(success=True, message=map_text)
+            return rooms_data
+            
+        elif any(cmd in command_lower for cmd in ['help', 'commands', '도움', '?', 'h']):
+            return await get_help()
+            
+        elif any(cmd in command_lower for cmd in ['talk', 'say', 'speak', 'tell', '대화', 'chat']):
+            # Extract message after talk command
+            talk_words = ['talk', 'say', 'speak', 'tell', '대화', 'chat']
+            message = command
+            for word in talk_words:
+                if word in command_lower:
+                    parts = command.split(word, 1)
+                    if len(parts) > 1:
+                        message = parts[1].strip()
+                        if message:
+                            break
+            
+            if not message or message == command:
+                message = "Hello!"
+            
+            # Use talk endpoint
+            talk_request = TalkRequest(message=message)
+            return await talk_to_npc(talk_request)
+            
+        elif any(cmd in command_lower for cmd in ['north', 'south', 'east', 'west', 'n', 's', 'e', 'w']):
+            # Direction shortcuts from hall
+            directions = {
+                'north': 'garden', 'n': 'garden',
+                'south': 'classroom', 's': 'classroom', 
+                'east': 'study', 'e': 'study',
+                'west': 'kitchen', 'w': 'kitchen'
+            }
+            for direction, room in directions.items():
+                if direction in command_lower:
+                    move_request = CommandRequest(command=f"go {room}")
+                    return await move_to_room(move_request)
+            
+        else:
+            # Try to interpret as a talk message if it doesn't match commands
+            if len(command.split()) > 1 and not any(cmd in command_lower for cmd in ['go', 'move', 'travel', 'examine', 'take']):
+                talk_request = TalkRequest(message=command)
+                return await talk_to_npc(talk_request)
+            
+            return GameResponse(
+                success=False, 
+                message=f"🤔 I don't understand '{command}'. Try 'help' for commands, or just type what you want to say to the NPC!"
+            )
+            
+    except Exception as e:
+        logger.error(f"Error processing command: {e}")
+        return GameResponse(success=False, message=f"Error: {str(e)}")
+
+if __name__ == "__main__":
+    print("Starting Korean Learning MUD Web Server...")
+    print("Make sure you have created 'korean_mud_game.html' in the project root")
+    print("Server will be available at: http://localhost:7860")
+    
+    # Use 0.0.0.0 for Docker compatibility, 127.0.0.1 for local dev
+    host = "0.0.0.0" if os.getenv("DOCKER_ENV") else "127.0.0.1"
+    
+    uvicorn.run(
+        "web_server:app",
+        host=host,
+        port=7860,
+        reload=False if os.getenv("DOCKER_ENV") else True,
+        log_level="info"
+    )