Parallax

A favorite artist. A film that stays with you. Where next?

You know what you love. You may not know which New York place to try.

PARALLAX turns two or three familiar artists or films into one shared shortlist. Qloo discovers places and ranks that same shortlist through each cultural reference. When those perspectives disagree, an exact decision model selects a comparison that could help you choose.

Your answer can change the recommendation. Removing it rebuilds the decision.

Actual studio capture using restored Qloo observations. Header animation is an original workflow illustration. Venue-photo credits remain visible in the studio and are documented in attribution.

Related MCP server: eodiseobwa-mcp

Follow one decision

Try Radiohead × Grand Budapest in the live studio. Choose Find my places, answer a comparison, then open 1 choice beside the history icon and remove that answer. Inspect what changes. No login, purchase or judge-supplied API key is needed for the hosted studio. Exact walkthrough →

Qloo is the foundation

flowchart LR
  A[Confirmed artists / films] --> B[Qloo place discovery]
  B --> C[One shared shortlist]
  C --> D[Qloo ranks each cultural lens]
  D --> E[Exact comparison selection]
  E --> F[An explicit human choice]
  F --> G[Updated shortlist + map]
  F --> E

Qloo provides both discovery and reference-conditioned rankings. Without those inputs, this workflow cannot prepare its culturally grounded candidate set. The adapter preserves the official discovery and supplied-shortlist contracts; it does not claim to execute the native Qloo harness.

• One common set: at most ten place identities, with coordinates in the supported New York area and coverage under every cultural lens. Missing ranks stay missing.

• A question with a purpose: a finite preference model evaluates expected reduction in modeled decision regret. Up to three relative choices; it can stop earlier.

• A decision you can correct: answers are recomputed from a clean prior when changed or removed. Neither creates reversible current-outing vetoes; both and skip invent no relative preference.

• A complete studio: comparisons, animated shortlist, before/after view, map, evidence, local preferences, field notes, and responsive licensed photography.

Decision methodology · Experience design · Photography

Give an agent the same tool

The parallax_advise MCP tool exposes resolve, prepare, advise and forget over one local stdio bridge to the public HTTPS backend. An assistant can obtain a comparison and ask the person to answer it. Supplied answers use the same decision engine as the studio.

After installing dependencies, run a real protocol demonstration:

npm run demo:agent

It confirms declared sample identities through Qloo, prepares a shared shortlist, applies a scripted demonstration answer, removes it, verifies the original decision is restored, and forgets temporary evidence. No key is printed or required by the public tool user. This is an actual MCP client invocation; no LLM is invoked by this demonstration. It consumes the public service's finite provider allowance.

Connect your MCP client →

Run locally

Node 24.x and the committed npm lockfile are required. Self-hosting needs your own authorized Qloo credential, a Postgres database, and a random session secret. The hosted studio already has its own configured backend.

npm ci
cp .env.example .env.local
# Set QLOO_API_KEY (or QLOO_KEY_FILE), SESSION_SECRET and DATABASE_URL privately.
# Apply server/migration.sql to your dedicated Postgres database.
npm run dev

Open the URL printed by the server. Credentials stay on the server. Configuration, database setup and quotas →

Evidence you can reproduce

npm test                 # Decision, HTTP and photographic-asset checks
npm run evaluate         # Seeded synthetic comparisons; not a human study
npm run build            # TypeScript + production client
npx playwright install chromium
npm run test:browser     # Actual UI + MapLibre with synthetic API fixtures

The verification record states the scope and limits. Synthetic results do not establish human enjoyment or universal recommendation superiority. Automated accessibility checks are not a full accessibility certification.

Inside the repository

Boundaries that matter

The first edition helps someone choose one New York place to try. Cultural association does not certify enjoyment, opening hours, entry conditions, accessibility or safety. The studio does not book venues or infer sensitive traits.

Studio preferences stay in IndexedDB on the person's device. The MCP bridge transmits explicitly supplied answers for transient backend computation; it creates no remote personal profile. Session-scoped provider evidence expires after thirty minutes. Exported preferences exclude credentials and bulk provider content.

Runtime operation requires no mandatory generative model, paid map API, or image subscription. Provider grants and free-service allowances remain finite. Unknown or ambiguous venues keep their Qloo ranking and receive an explicit photo placeholder. Privacy and operation →

License

Application source: MIT, Kathirvel R. Third-party photography, fonts, map software, map data, and Qloo content retain their individual licenses and terms. Attribution and rights →