How artunbalta/echo works
ECHO is a browser-based virtual world whose central experience is walking through a village, encountering small behavioral moments, and opening predictions sealed by a personal “echo.” The world, procedural planet, and envelope-based predictions are the principal user-facing stages; a separate optional ML service learns an eight-axis persona from behavioral signals. The README also describes friend-prediction links, an opt-in pilot, and public twin-audit research. Some subsystem links are documented only at product level; unsampled route wiring is not inferred.
Main entry points: scene.ts Planet scene · persona.py Persona model · WorldCore.ts World engine · WorldClient.tsx World client
Components 21
World experience
- World client
apps/web/src/components/WorldClient.tsx - World engine
apps/web/src/game/WorldCore.ts - World actions API
apps/web/src/app/api/world/act/route.ts - Sealed envelopes
apps/web/src/lib/knowable/envelopes.ts
World simulation
- Planet scene
packages/planet/lib/scene.ts - Terrain
packages/planet/lib/terrain.ts - World affordances
packages/planet/lib/assets.ts - Behavioral moments
packages/planet/lib/moments.ts - Village society
packages/planet/lib/society.ts
Echo and prediction
- Behavioral API
apps/web/src/app/api/observe/behavioral/route.ts - Learning service
services/ml/echo_ml/app.py - Event ingestion
services/ml/echo_ml/ingest.py - Persona model
services/ml/echo_ml/persona.py - Eight axes
services/ml/echo_ml/persona_axes.py - Signal embeddings
services/ml/echo_ml/embeddings.py - Persona inference
services/ml/echo_ml/persona_model.py
Supporting services
- Venue dialogue
apps/web/src/lib/venue/dialogue/live-engine.ts - Dialogue outcomes
apps/web/src/lib/venue/npc/outcome.ts
Research
- Friend prediction pilot
research/pilot/echo_pilot/engine.py - Twin audit research
research/deeds/fair_llm_twin2k.py
Other components
- Player
Connections 18
- Player → World client: enters
README.md - World client → World engine: renders
- World engine → World actions API: submits actions
- Player → Sealed envelopes: opens predictions
README.md - World engine → Planet scene: renders world
- Planet scene → Terrain: uses terrain
- Planet scene → World affordances: uses affordances
packages/planet/lib/assets.ts - Planet scene → Behavioral moments: hosts moments
- Planet scene → Village society: populates villages
- Behavioral API → Learning service: forwards signals
- Learning service → Event ingestion: routes events
services/ml/echo_ml/app.py - Event ingestion → Persona model: derives observations
services/ml/echo_ml/ingest.py - Persona model → Eight axes: uses axis definitions
services/ml/echo_ml/persona.py - Persona model → Signal embeddings: uses embeddings
services/ml/echo_ml/persona.py - Persona model → Persona inference: uses inference model
services/ml/echo_ml/persona.py - Venue dialogue → Dialogue outcomes: resolves outcomes
apps/web/src/lib/venue/dialogue/live-engine.ts - Player → Friend prediction pilot: predicts friends
README.md - Player → Twin audit research: audits twins
README.md