Spaces:
Sleeping
Download README.md from ramsi-k/korean-cpc-agents: direct link, hf CLI and curl.
- Browser
- Download file 5.74 kB
-
https://huggingface.co/spaces/ramsi-k/korean-cpc-agents/resolve/main/README.md
- Command line
-
hf download hf://spaces/ramsi-k/korean-cpc-agents/README.md
-
curl -L -o README.md https://huggingface.co/spaces/ramsi-k/korean-cpc-agents/resolve/main/README.md
title: Korean Cpc Agents
emoji: π»
colorFrom: indigo
colorTo: green
sdk: docker
pinned: false
license: mit
short_description: Interactive Korean language learning MUD game
Korean Learning MUD Game π°π·
Interactive Korean language learning through conversation with AI-powered Korean family members in a retro MUD-style game.
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:
How to Play
Basic Commands
look- Look around your current roomgo [room]- Move to another room (kitchen, garden, bedroom, study, classroom, hall)examine [object]- Examine objects to learn Korean vocabularychat [message]- Talk to the Korean family member in your roomhelp- Show all available commandsmap- See the house layout and room locations
Game Flow
- Start in the Hall - Central hub connecting all rooms
- Visit Family Members - Each room has a different Korean family member
- Examine Objects - Learn vocabulary and cultural context
- Practice Conversations - Natural Korean language practice
- Track Progress - See words learned and objects examined
Screenshots
Main game interface with retro terminal styling
Learning proper Korean honorifics with Grandma in the Kitchen
Traditional Korean wisdom and proverbs in the Garden
Track your Korean learning progress and cultural discoveries
Quick Start
Option 1: Docker (Recommended)
Clone and navigate to project:
git clone https://github.com/Ramsi-K/korean-cpc-agents cd korean-cpc-agentsSet up environment:
# Create .env file with your OpenAI API key echo "OPENAI_API_KEY=your-api-key-here" > .envRun with Docker Compose:
docker compose up --buildPlay the game: Open http://localhost:7860 in your browser!
Option 2: Local Development
Install dependencies:
uv syncSet up your OpenAI API key:
export OPENAI_API_KEY="your-api-key-here"Run the game:
uv run python web_server.pyOpen your browser:
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
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





