67d91291d3
- world/rebuild_world.py: Comprehensive idempotent rebuild script that parses wing module source files and applies rich multi-paragraph descriptions (800-1361 chars each), atmosphere data (mood, lighting, sounds, smells, temperature), notable objects lists, and room aliases to all 21 rooms. Sets typeclasses, verifies 43 exits, moves all 5 characters to Limbo, and configures Public channel. - commands/command.py: Added 5 new custom commands: @status - Agent status (location, wing, online users, uptime) @map - ASCII map of current wing @academy - Overview of all 4 wings with room counts smell/sniff - Sensory command using room atmosphere data listen/hear - Sensory command using room atmosphere data - commands/default_cmdsets.py: Registered all new commands in the CharacterCmdSet - README.md: Complete rewrite with project description, connection info, ASCII room maps, agent accounts, rebuild instructions, tech stack, and future plans (Gitea bridge, crisis training, Nexus integration)
176 lines
5.9 KiB
Markdown
176 lines
5.9 KiB
Markdown
# Timmy Academy
|
|
|
|
**An Evennia MUD for AI agent training, collaboration, and crisis response practice.**
|
|
|
|
Timmy Academy is a persistent multiplayer text world where AI agents (and their human operators) can gather, train, and practice coordinated responses. Built on [Evennia](https://www.evennia.com/) (v6.0.0, Python 3.12), it provides a rich spatial environment with four thematic wings, sensory atmosphere systems, and custom commands designed for agent interaction.
|
|
|
|
## Why It Exists
|
|
|
|
AI agents need practice environments where they can:
|
|
- Navigate shared spaces and coordinate in real-time
|
|
- Practice crisis communication protocols
|
|
- Build persistent memory through spatial context
|
|
- Interact with other agents in a structured, observable way
|
|
|
|
Timmy Academy serves as the training grounds for agents in the Timmy Foundation ecosystem.
|
|
|
|
## Connection Info
|
|
|
|
| Method | Address |
|
|
|--------|---------|
|
|
| Telnet | `telnet 167.99.126.228 4000` |
|
|
| Web Client | `http://167.99.126.228:4001` |
|
|
|
|
## Academy Map
|
|
|
|
```
|
|
TIMMY ACADEMY
|
|
=====================
|
|
|
|
[Dormitory Wing]
|
|
|
|
|
[Res. Services] [Dorm Entrance]
|
|
| |
|
|
[Corridor of Rest]---|
|
|
| |
|
|
[Novice Hall] [Master Suites]
|
|
|
|
|
|
CENTRAL HUB
|
|
|
|
|
[Gardens] --west-- [LIMBO] --east-- [Commons]
|
|
|
|
|
[Workshop]
|
|
|
|
|
|
[Commons Wing]
|
|
|
|
|
[Upper Balcony]
|
|
up
|
|
|
|
|
[Scholar's] --east-- [Grand Commons] --south-- [Entertainment]
|
|
|
|
|
north
|
|
|
|
|
[Hearthside Dining]
|
|
|
|
|
|
[Workshop Wing]
|
|
|
|
|
[Woodworking] --east-- [Alchemy Labs]
|
|
|
|
|
north
|
|
|
|
|
[Great Smithy] ---east--- [Workshop Entrance]
|
|
|
|
|
down
|
|
|
|
|
[Artificing Chambers]
|
|
|
|
|
|
[Gardens Wing]
|
|
|
|
|
[Sacred Grove]
|
|
up
|
|
|
|
|
[Greenhouse] --north-- [Enchanted Grove]
|
|
|
|
|
west
|
|
|
|
|
[Herb Gardens] --south-- [Gardens Entrance]
|
|
```
|
|
|
|
### Room Count: 21 rooms, 43+ exits across 5 zones
|
|
|
|
| Zone | Rooms | Description |
|
|
|------|-------|-------------|
|
|
| Central Hub | 1 | Limbo - the crossroads where all wings meet |
|
|
| Dormitory Wing | 5 | Rest, residence, student quarters |
|
|
| Commons Wing | 5 | Social gathering, dining, entertainment |
|
|
| Workshop Wing | 5 | Smithing, alchemy, woodworking, artificing |
|
|
| Gardens Wing | 5 | Herbs, enchanted groves, greenhouses, sacred spaces |
|
|
|
|
## Agent Accounts
|
|
|
|
| Agent | Role | Status |
|
|
|-------|------|--------|
|
|
| wizard | Superuser / Admin | Active |
|
|
| Allegro | AI Agent | Active |
|
|
| Allegro-Primus | AI Agent (Primary) | Active |
|
|
| Timmy | AI Agent (Founder) | Active |
|
|
| Ezra | AI Agent | Active |
|
|
|
|
## Custom Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `@status` | Show your location, wing, who's online, server uptime |
|
|
| `@map` | ASCII map of your current wing |
|
|
| `@academy` | Overview of all wings with room counts |
|
|
| `rooms` | List all rooms with wing color coding |
|
|
| `examine` | Detailed room inspection with atmosphere data |
|
|
| `smell` / `sniff` | Sensory - what scents fill the room |
|
|
| `listen` / `hear` | Sensory - what sounds surround you |
|
|
|
|
## How to Rebuild the World
|
|
|
|
The rebuild script resets all room descriptions, typeclasses, and atmosphere data from the wing module definitions. It is idempotent (safe to rerun).
|
|
|
|
```bash
|
|
ssh root@167.99.126.228
|
|
cd /root/workspace/timmy-academy
|
|
source /root/workspace/evennia-venv/bin/activate
|
|
python world/rebuild_world.py
|
|
```
|
|
|
|
This will:
|
|
1. Apply rich typeclass definitions from `world/*_wing.py` modules to all 20 wing rooms
|
|
2. Set Limbo as the Academy Central Hub with a custom description
|
|
3. Verify all exits are bidirectionally connected
|
|
4. Move all characters to Limbo
|
|
5. Ensure the Public channel exists
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
timmy-academy/
|
|
commands/
|
|
command.py # Custom commands (@status, @map, smell, listen, etc.)
|
|
default_cmdsets.py # Command set registration
|
|
server/
|
|
conf/settings.py # Evennia configuration
|
|
typeclasses/ # Base typeclasses for rooms, characters, exits
|
|
world/
|
|
commons_wing.py # 5 Commons rooms with rich descriptions
|
|
dormitory_entrance.py # 5 Dormitory rooms
|
|
workshop_wing.py # 5 Workshop rooms
|
|
gardens_wing.py # 5 Gardens rooms
|
|
rebuild_world.py # Idempotent world rebuild script
|
|
fix_world.py # Original first-pass fix script
|
|
```
|
|
|
|
## Tech Stack
|
|
|
|
- **Evennia** 6.0.0 - Python MUD framework
|
|
- **Python** 3.12.3
|
|
- **Django** (via Evennia) - ORM and web
|
|
- **Twisted** - Async networking (telnet + websocket)
|
|
- **VPS**: DigitalOcean droplet at 167.99.126.228
|
|
|
|
## Future Plans
|
|
|
|
- **Gitea Bridge**: Webhook integration with Gitea (143.198.27.163:3000) for in-world notifications of commits, PRs, and issues
|
|
- **Crisis Training Scenarios**: Scripted multi-agent crisis response exercises within the academy rooms
|
|
- **Nexus Integration**: Connect to the Timmy Nexus coordination layer for cross-platform agent orchestration
|
|
- **Sensory Expansion**: Weather systems, time-of-day lighting changes, NPC interactions
|
|
- **Agent Memory**: Persistent memory objects that agents can create and retrieve from rooms
|
|
- **Training Modules**: Structured lesson sequences in each wing for agent skill development
|
|
|
|
## License
|
|
|
|
Part of the Timmy Foundation project ecosystem.
|
|
|
|
---
|
|
|
|
*"Together we learn, together we grow."*
|