Charts, manual meal and lab entry, correlations, comparisons, JSON import, and data export work without an AI provider. PDF/image import, meal-photo or nutrition-label analysis, chat, Current Focus generation, and AI interpretation need a provider.
Steps
Already have Codex, OpenCode, Hermes, Grok Build, or OpenClaw installed? You can use it as your AI provider through CLI agents and Companion. This is optional; non-AI features need only the browser app.1
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 where your browser supports installation. After the app finishes caching, browser-local features can work offline. Installation options vary by browser and operating system; network providers and optional model downloads have separate connectivity needs. See App updates and offline use for update prompts and recovery.Then open
Self-hostingIf you prefer to run getbased yourself, use Node.js 24, clone the repository, install dependencies, and start a local server:
http://localhost:8000/app. These commands build the TypeScript, Svelte and style sources for local development. For a public static host, build and publish the complete dist/ artifact instead. See Self-hosting for configuration and updates.2
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.
3
Connect AI only when you need it
An AI provider is required for PDF/image import, meal-photo or nutrition-label analysis, 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 — hosted AI with optional browser-side message encryption and limited attestation checks.
- Local AI — a direct connection to Ollama, LM Studio, Unsloth Studio, Jan, or another compatible server on this device, your LAN, or a remote host.
- Custom API — any OpenAI-compatible endpoint.
4
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.With a compatible chat model, you can also describe a changed routine or paste an existing health summary. getbased can prepare updates for several records; review each Apply / Discard card before saving. You can fill context manually at any time. See Health updates in chat.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, lifestyle context, and a multi-week meal history
- Alex — metabolic health, Withings body composition, OAT and EMF assessment data, and a multi-week meal history
5
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, daily nutrition, biometrics, light context, and key trends.Use the sidebar on desktop, or swipe the bottom tabs and use the menu on mobile, to move through:
- Labs — biomarker charts, tables, heatmaps, and marker detail views
- Biology Scores — Biological Coherence, score domains, and coverage planning
- Biometrics — wearables, manual body metrics, connected sources, and cycle tracking
- Nutrition — meals, targets, history, and Fuel Mix Context
- Supplements & Meds — supplement and medication history
- Light — sun sessions, therapy devices, indoor light, and measurement tools
- Genome — raw DNA, APOE, mtDNA, and SNP context
- 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