A pixel art world simulation where AI characters with unique personalities interact, form relationships, and experience real-time emotions.
Powered by the molroo emotion engine.
Each character has a distinct HEXACO personality profile that shapes how they act and react. When characters interact, the molroo emotion engine computes realistic emotional responses using a VAD (Valence-Arousal-Dominance) model.
- Characters autonomously choose who to interact with and what actions to take
- Emotional state changes in real-time based on interactions
- Relationships evolve over time -- characters remember how others treated them
- 16 different interaction types from affection to betrayal
git clone https://github.com/molroo-io/persona-world.git
cd persona-world
npm install
cp .env.example .env # Add your API key
npm run dev # Open http://localhost:5173Only VITE_API_KEY is required. On first run, the app automatically creates a world and seeds 12 characters via the molroo SDK.
Get your API key at molroo.io.
| Variable | Required | Description |
|---|---|---|
VITE_API_KEY |
Yes | API key from molroo.io |
VITE_WORLD_ID |
No | Use an existing world (auto-created if omitted) |
VITE_API_URL |
No | API base URL (default: https://api.molroo.io) |
12 pre-configured characters defined in src/data/personas.ts. Each has a unique HEXACO personality profile that you can customize:
| Name | Personality | Traits |
|---|---|---|
| Luna | Dreamy painter | Creative, Sensitive |
| Rex | Gym coach | Extraverted, Competitive |
| Sage | Stoic philosopher | Calm, Sincere |
| Miko | Cafe owner | Cooperative, Disciplined |
| Kai | Restless traveler | Creative, Extraverted |
| Nyx | Brooding poet | Introverted, Sensitive |
| Ari | Village nurse | Cooperative, Sincere |
| Zed | Cunning trickster | Extraverted, Pragmatic |
| Sol | Retired captain | Disciplined, Sincere |
| Ivy | Ambitious journalist | Creative, Extraverted |
| Finn | Shy librarian | Creative, Sensitive |
| Rosa | Street dancer | Extraverted, Creative |
- Frontend: React 19 + TypeScript + Vite
- Rendering: Canvas 2D with pixel art sprites
- Emotion Engine: @molroo-io/sdk
- i18n: Auto-detects browser language (English / Korean). Override with
?lang=enor?lang=ko
User/Auto Action -> molroo API -> Emotion Engine -> VAD Response -> UI Update
|
HEXACO Personality
Appraisal Model
Emotional Memory
- An action (e.g. "praise", "tease", "betray") is sent to a target character
- The molroo emotion engine appraises the action based on the character's personality
- A new emotional state (VAD + discrete emotion label) is computed
- The UI reflects the change -- facial expression, color, emotion label, and relationship score
npm run build # Production build -> dist/MIT