MerchantryTidbits

research-workflow / app

History (Valyu globe)

Capability: History (Valyu globe)

Use it when

  • You found an obscure island, settlement, or landmark on a map and want a sourced historical account instead of piecing together scattered Wikipedia stubs, PDFs, and forum posts
  • You need quick, citation-backed location context for travel planning, teaching, or historical research across archives and academic databases

What it solves

Not the fit when

  • Offline research: every run requires the Valyu DeepResearch API and Mapbox.
  • Free unlimited use: the README estimates approximately $0.10 for the fast model or $0.50 for the heavy model per research run.
  • Fully local or private research storage: self-hosted SQLite stores metadata and Valyu task IDs, while the full research content remains in Valyu's DeepResearch API.
  • Guaranteed depth for places with little digitized source material; citations still require user verification.
  • Share links are public; do not share sensitive research through them.
  • research on topics not tied to a geographic location
  • offline research without API access
  • primary source digitization
  • general web scraping

Install

git clone https://github.com/yorkeccak/history && cd history && pnpm install; create .env.local with NEXT_PUBLIC_APP_MODE=self-hosted, VALYU_API_KEY, and NEXT_PUBLIC_MAPBOX_ACCESS_TOKEN, then pnpm dev (or one-click deploy to Vercel)

Invoke

Open http://localhost:3000 and click any location on the 3D satellite globe (or hit Random Location); watch the deep-research run live for up to 10 minutes and review the cited report saved in the sidebar

Alternatives

No reviewed alternatives recorded yet.