🧌 Goblin Habitat

An emergent AI simulation where a goblin lives, remembers, and evolves in a cozy dark fantasy grove.

Quick Start

Local Development

1. Install dependencies:

   cd goblin-habitat
   pip install -r requirements.txt

2. Set up environment:

   cp .env.example .env
   # Edit .env with your NanoGPT API key

3. Run the application:

   python main.py

4. Open in browser:

   http://localhost:8000
   

Docker Deployment

1. Set up environment:

   cp .env.example .env
   # Edit .env with your NanoGPT API key

2. Build and run:

   docker compose up -d --build

3. Access:

   http://your-vps-ip:8420
   

Features

• 🧌 AI-Driven Goblin - Makes decisions, writes diary entries, reflects on experiences
• 📔 Diary System - Persistent journal entries capturing the goblin's thoughts
• ⚡ Skills & Progression - Fishing, woodcutting, reading, cooking
• 🌦️ Dynamic Weather - Rain, fog, storms, seasons
• 🌙 Day/Night Cycle - Synced to real time
• 💡 Activity Suggestions - The goblin can request new activities
• 📊 Dashboard - View stats, diary, skills, and activity log

Configuration

Edit config.py to customize:

• Cycle interval (default: 30 minutes)
• Personality traits
• World locations
• Activity definitions

API Endpoints

• GET /api/state - Full simulation state
• GET /api/goblin - Goblin info
• GET /api/diary - Diary entries
• GET /api/skills - Skill levels
• POST /api/trigger-cycle - Manually trigger a cycle
• WS /ws - Real-time WebSocket updates

License

MIT