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.