How sidevworks/rare-atlas works
Rare Atlas turns a visitor’s typed or spoken question into source-backed graph lookups, then presents related diseases, evidence, patient-group resources, studies, and possible next steps through a 3D atlas and desk. The documented data path builds wide open-data links and a hand-checked deep layer, then serves graph lookups and short-lived voice sessions. The README documents several capabilities whose route implementations were not sampled; those relationships are cited to the README rather than inferred from filenames.
Main entry points: build.js Wide-layer builder · api Lookup routes · retrieval.js Retrieval tools · main.js Atlas boot
Components 24
Atlas experience
- Atlas boot
src/main.js - Search and desk
src/ui/index.js - Typed search
src/ui/search.js - Retrieval tools
src/retrieval.js - Voice agent
src/voice/index.js - Event bus
src/bus.js - 3D atlas
src/world/index.js - Browser API
src/api.js
Lookup service
- Lookup routes
api - Graph search
api/_lib/search.js - Graph access
api/_lib/graph.js - Voice session
api/realtime-session.js
Graph data
- Graph storage
api/_lib/store.js - Graph schema
shared/schema.js
Data preparation
- Wide-layer builder
loader/build.js - Sourced links
loader/wide/edges.js - Name reconciliation
loader/wide/reconcile.js - Deep-layer curation
loader/deep/run.js - Graph upload
loader/upload.js
Mondo floor
- Mondo mosaic
src/world/mondo-floor.js - Mondo floor build
loader/mondo/build.js
Other components
- Visitor
- OpenAI Realtime
- Open data sources
Connections 27
- Visitor → Typed search: asks
- Visitor → Voice agent: speaks to
- Atlas boot → Browser API: fetches map
src/main.js - Atlas boot → Search and desk: creates UI
src/main.js - Atlas boot → 3D atlas: creates world
src/main.js - Typed search → Retrieval tools: runs lookup
src/ui/search.js - Voice agent → Retrieval tools: runs tool
src/voice/index.js - Retrieval tools → Event bus: emits results
src/retrieval.js - Search and desk → Event bus: listens
src/ui/index.js - Retrieval tools → Browser API: requests lookups
src/retrieval.js - Browser API → Lookup routes: calls endpoints
- Lookup routes → Graph search: searches graph
api/search.js - Graph search → Graph storage: reads index
api/_lib/search.js - Lookup routes → Graph access: checks claims
api/_lib/graph.js - Graph access → Graph storage: reads graph
- Lookup routes → Voice session: mints sessions
api/realtime-session.js - Voice session → OpenAI Realtime: mints secret
api/realtime-session.js - Voice agent → OpenAI Realtime: connects directly
- Wide-layer builder → Open data sources: reads files
- Wide-layer builder → Name reconciliation: reconciles names
loader/build.js - Wide-layer builder → Sourced links: builds links
loader/build.js - Sourced links → Graph schema: creates typed edges
loader/wide/edges.js - Deep-layer curation → Open data sources: adds curated data
- Wide-layer builder → Graph upload: writes build
- Deep-layer curation → Graph upload: uploads layer
- Graph upload → Graph storage: writes graph
- Mondo floor build → Mondo mosaic: produces floor data