Skip to content

innercartography/ROOM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

18 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ROOM logo

ROOM

A semantic memory layer for the spatial internet.
Places hold memory. Multiple knowledge graphs coexist without collapsing.

Live Demo ย  Hyperblog v3

PLACES Track Hackathon Location Zero Build


What Is ROOM?

Photorealistic Gaussian splats create stunning 3D environments โ€” but they are ghost worlds. No memory, no events, no searchability. Beautiful places you can see but can't understand.

ROOM adds the missing layer. A semantic memory graph that gives spatial coordinates meaning โ€” not collision meshes, not physics, but knowledge.

Gaussian splats give you the Visual. ROOM gives you the Meaning.


The Spatial Information Stack

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  ๐ŸŽจ  Visual        Pixels, textures, rendering   โ”‚  โ† Gaussian Splats
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  ๐Ÿ“  Geometric     3D shape, volume, topology    โ”‚  โ† Meshes
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  โš™๏ธ  Physical      Collision, dynamics, forces   โ”‚  โ† Physics engines
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  ๐Ÿง   SEMANTIC      Meaning, memory, knowledge    โ”‚  โ† ROOM โœฆ
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

ROOM operates at the foundational Semantic layer โ€” below everything else. It adds what Gaussian splats are missing: what a place means, not just what it looks like.


Four Ontological Primitives

ROOM reduces spatial memory to four atomic types โ€” mirroring how the hippocampus encodes it.

Primitive Symbol Role
Place ๐Ÿ“ A spatial coordinate or region. The irreducible ground.
Event โšก A happening anchored to a Place with a timestamp.
Perspective ๐Ÿ‘๏ธ A viewpoint on an Event โ€” carrying ontological metadata.
Artifact ๐Ÿ“„ A crystallized output โ€” document, media, or insight.

Multiple Perspectives on the same Event coexist without collapsing. An architect sees structure. A sociologist sees gathering patterns. A mythologist sees story. All are true simultaneously.


Live Demo

โ†’ room-openmetaverse.vercel.app

Four pages, zero build step:

Page What it does
Landing (/) Spatial stack explainer, Ghost World problem/solution, four primitives, demo flow
Tower (/tower) 3D Three.js model of Frontier Tower with interactive floor labels โ€” click a floor to explore its knowledge graph
Viewer (/viewer) 3D scene with semantic node overlays, WASD navigation, guided 14-stop tour, ontology filtering, perspective switching
Editor (/editor) D3.js force-directed knowledge graph editor with full CRUD, drag persistence, JSON export, and Claudesidian PKG bridge

Quick Start

git clone https://github.com/innercartography/ROOM.git
cd ROOM

# No install. No build. Just serve.
npx serve . -l 3000

Open localhost:3000 and explore.


Architecture

room-openmetaverse/
โ”œโ”€โ”€ index.html          Landing page โ€” hero, spatial stack, primitives, demo flow
โ”œโ”€โ”€ tower.html          Three.js 3D tower with interactive floor navigation
โ”œโ”€โ”€ viewer.html         Three.js 3D viewer + CSS2DRenderer + guided tour + WASD
โ”œโ”€โ”€ editor.html         D3.js force-directed graph editor + entity sidebar
โ”œโ”€โ”€ room.js             Shared data layer โ€” CRUD, queries, validation, events
โ”œโ”€โ”€ styles.css          Design system โ€” dark space theme, glassmorphism, animations
โ”œโ”€โ”€ sample-world.json   18-node demo graph (Frontier Tower ยท knowledge capsules)
โ”œโ”€โ”€ world.json          User's active world file
โ”œโ”€โ”€ rp1-scene.json      RP1 spatial fabric scene config
โ”œโ”€โ”€ frontier-tower.jpg  Hero image of the building
โ”œโ”€โ”€ favicon.svg         ROOM logo
โ””โ”€โ”€ vercel.json         Deployment config (clean URLs, CORS for JSON)

room.js โ€” The Data Layer

A zero-dependency shared module exposing the full ROOM API:

ROOM.loadWorldFromURL('sample-world.json');   // Load a world
ROOM.getPlaces();                              // โ†’ all Place nodes
ROOM.getEventsAtPlace('place-lobby');          // โ†’ Events anchored here
ROOM.getPerspectivesForEvent('event-hackathon'); // โ†’ Multiple viewpoints
ROOM.getPlaceContext('place-16th-floor');      // โ†’ Full context tree
ROOM.obsidianToPerspective(markdown);          // โ†’ Claudesidian bridge
ROOM.exportWorld();                            // โ†’ Portable JSON
ROOM.validate();                               // โ†’ Schema validation

Data Format: world.json v0.1

Flat JSON graph โ€” portable, human-readable, no build step required.

{
  "version": "room/v0.1",
  "meta": { "title": "...", "created": "..." },
  "nodes": [
    { "id": "place-lobby", "type": "place", "label": "Frontier Tower", "position": [0,0,0] },
    { "id": "event-kickoff", "type": "event", "label": "Hackathon Kickoff", "time": "..." },
    { "id": "capsule-thesis", "type": "perspective", "ontology": "experiential", "content": "...", "capsule": true }
  ],
  "edges": [
    { "source": "event-kickoff", "target": "place-lobby", "type": "anchored_at" }
  ],
  "tour": { "title": "...", "waypoints": [{ "node": "...", "narration": "..." }] }
}

Edge types: anchored_at ยท observes ยท produced_by ยท leads_to

Ontologies: architectural ยท social ยท experiential ยท mythological ยท technical ยท personal ยท bioregional


Knowledge Capsules

The demo graph includes knowledge capsules โ€” spatialized perspective nodes drawn from the ROOM Hyperblog, omb.wiki, and Resonance Lab field notes:

Capsule Ontology Location
๐Ÿง  The Collective Hippocampus Technical 16th Floor
๐ŸŒ The Spatial Fabric Technical 16th Floor
๐Ÿ›๏ธ Places Can Remember Experiential 16th Floor
๐Ÿ“œ Open Standards Technical 16th Floor
๐Ÿ“ The Missing Semantic Layer Technical 16th Floor
๐Ÿ”’ Knowledge Sovereignty Personal 16th Floor
๐Ÿ”ฌ Resonance Lab โ€” Field Notes Social 16th Floor
๐Ÿ˜๏ธ Digital Villages Social Alien Lounge
๐Ÿ”ฎ Shards of Memory Experiential Alien Lounge
๐Ÿ‘ฝ Alien โ€” Proving Humanity Technical Alien Lounge
๐Ÿช™ Tokens in the Spatial Fabric Social Alien Lounge

Frontier Tower โ€” The Demo Site

Three spatial captures from the 1st Annual Open Metaverse Hackathon:

# Location Description
1 ๐Ÿšช Lobby & Entrance Street-level threshold at 995 Market St
2 ๐Ÿ›ธ The Alien Lounge Silver mylar, the Arecibo message, and alien.org โ€” proving humanity in the age of AI
3 โšก 16th Floor Hackathon Space Where builders gather and ROOM came alive

Integrations

Partner Role
RP1 Open metaverse browser ยท spatial fabric ยท the map of the metaverse
arrival.space Gaussian splat hosting + streaming
Claudesidian Obsidian markdown โ†’ ROOM Perspective nodes (personal knowledge graphs)
Polycam Spatial capture โ†’ .ply export for Place nodes
alien.org Decentralized human verification ยท token interoperability for spatial villages
Metaverse Standards Forum Open metaverse interoperability standards

Hyperblog

ROOM is documented through a living hyperblog โ€” a spatial essay that evolves with the project:

โ†’ ROOM Hyperblog v3


Hackathon Context

Open Metaverse Hackathon ยท March 7โ€“8, 2026 ยท Frontier Tower, San Francisco

ROOM is a PLACES track entry โ€” building a semantic digital twin of Frontier Tower. Three spatial captures, eleven knowledge capsules, multiple ontological perspectives, one shared memory graph.


License

MIT โ€” You own what you create.

Built by Inner Cartography for the 1st Annual Open Metaverse Hackathon.

About

Make room

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors