Charts, manual entry, correlations, comparisons, JSON import, and data export work without an AI provider. PDF/image import, chat, Current Focus generation, and AI interpretation need a provider.
Steps
Open the app
Go to app.getbased.health in any modern browser. No sign-up or download required.Install as a PWA (optional)You can install getbased as a Progressive Web App for a native-like experience on desktop or mobile. The app shell works offline once installed. AI features still need a network connection to reach your provider.
Self-hostingIf you prefer to run getbased yourself, clone the repository and start a local server:Then open
| Browser | How to install |
|---|---|
| Chrome / Edge | Click the install icon in the address bar, or open the browser menu and select “Install getbased” |
| Safari (iOS) | Tap Share, then “Add to Home Screen” |
| Firefox | Open the browser menu and select “Install” |
http://localhost:8000. A local server is required because the app uses native ES modules.Take the first-visit tour
The first time you open a fresh profile, getbased starts a five-step empty-profile tour. It points out the guided chat, demo profiles, profile switcher, and Settings.When the tour finishes, guided chat opens. Chat is the main first-run path: it asks for context only when useful, then routes you to labs, DNA, wearables, light setup, or first-test planning.You can replay the populated app tour later from Settings → Display → Guided Tour.
Connect AI only when you need it
An AI provider is required for PDF/image import, AI chat, Current Focus generation, and AI-powered interpretations. You can explore demo data or enter values manually before setting one up.Open Settings (gear icon) and select AI. getbased supports several provider paths:
- OpenRouter — easiest to start. Use one-click OAuth or paste an API key.
- PPQ — pay-per-query with crypto top-ups, no KYC, and optional Private TEE mode.
- Routstr — decentralized Bitcoin AI with a built-in Cashu wallet.
- Venice AI — privacy-focused cloud AI with optional end-to-end encryption.
- Local AI — Ollama, LM Studio, Jan, or another local OpenAI-compatible server.
- Custom API — any OpenAI-compatible endpoint.
Add data or load a demo
Start with guided chatOn a new profile, click Start guided chat. Chat can help you decide whether to import labs, add DNA, connect wearables, set up light context, or fill Manage → Context later.Import directlyUse the header import button or drag files onto the page. getbased recognizes lab PDFs, lab photos/screenshots, raw DNA files, getbased JSON exports, and database bundles. When an AI provider is connected, the empty state also shows Import directly.Try a demo profileIf you do not have data on hand, load one of the built-in demo profiles:
- Sarah — iron, hormones, Oura, cycle context, supplements, and lifestyle context
- Alex — metabolic health, Withings body composition, OAT data, and EMF assessment data
Explore the dashboard
The dashboard is a customizable overview, not the only place where work happens. The default widgets surface Biological Coherence when available, current focus, biological age, recommended next steps, priority markers, quick markers, biometrics, light context, and key trends.Use the sidebar on desktop, or the bottom tabs and menu on mobile, to move through:
- Labs — biomarker charts, tables, heatmaps, and marker detail views
- Genome — raw DNA, APOE, mtDNA, and SNP context
- Body — wearables, manual body metrics, supplements, and cycle tracking
- Light — sun sessions, therapy devices, indoor light, and measurement tools
- Insight — Current Focus, AI insights, Manage → Context, and synthesis
- Recommendations — data-linked next steps across all lenses
- Compare dates and Correlations — analysis tools for lab changes and marker pairs