The Adventurer's Terminal

An immersive, text-based RPG experience powered by AI that lets you create characters, explore worlds, and forge your own adventure narrative.

🎮 Features

Character Management

• Create multiple characters with unique classes, traits, and stats
• Characters maintain their own inventory, location, and adventure history
• Track character health points (HP) that change based on in-game events

World System

• Multiple worlds with unique lore and descriptions
• Create new worlds during character creation
• Each world has its own location hierarchy and memory
• Characters remember their world and position between sessions

Memory and Narrative

• AI generates a narrative summary of your adventures
• Long-term memory system remembers key events and encounters
• Location-specific memories recreate the feeling of returning to places
• Characters recall information relevant to current situations

Exploration System

• Dynamic location tracking that follows your journey
• Hierarchical locations (cities containing districts containing buildings)
• Location summaries generated from your interactions
• Smooth transitions between connected areas

Special Commands

• location - View your current location and its parents
• inventory - Check your inventory
• recall memory - Access character memories
• recall memory about X - Search for specific memories
• world - Display information about the current world
• quit - Save and exit the game

🧙‍♂️ Getting Started

1. Install requirements: pip install -r requirements.txt
2. Set up your OpenAI API key in an .env file: OPENAI_API_KEY=your-key-here
3. Run the game: python main.py
4. Create a character or choose an existing one
5. Start typing actions to play!

🌍 World Customization

To customize your game world:

1. Edit the world_lore.txt file in your world's directory (save/worlds/YOUR_WORLD_NAME/)
2. Add detailed descriptions of places, people, history, magic systems, etc.
3. The AI will use this information dynamically during your adventure
4. Each character can have their own world, or share a world with others

🧰 Tech Stack

• Python 3.10+ — Main programming language
• OpenAI GPT-4o-mini — AI game master and narrative generator
• Rich — Styled terminal output with colors and formatting
• Pydantic — Data validation and settings management
• FAISS & Sentence Transformers — Semantic search for memories and world lore
• JSON — Character and world state persistence

🌟 Future Enhancements

• Improved inventory and item system
• Combat system enhancements
• Character skill progression
• Multi-character parties
• Character-to-character interaction
• Quest tracking