# getbased

> Personal health intelligence that's actually yours — free, local-first, no account required.

- [getbased: Health intelligence that's actually yours](https://docs.getbased.health/introduction.md): getbased is a free, open-source personal health platform that integrates labs, DNA, meals, wearables, light, and AI — all stored locally in your browser.
- [Get started with getbased in under ten minutes](https://docs.getbased.health/quickstart.md): Launch getbased in your browser, take the first-visit tour, connect an AI provider when you need it, and add labs, DNA, meals, wearables, or demo data.
- [Use the dashboard](https://docs.getbased.health/guides/dashboard.md): Tour the getbased dashboard — first-visit setup, default widgets, profile lenses, customization controls, and mobile bottom-tab navigation.
- [How getbased protects your health data](https://docs.getbased.health/guides/privacy.md): getbased keeps your health data local by default, with opt-in encrypted sync and password-protected sharing when you choose to use them.
- [Connect an AI provider to getbased](https://docs.getbased.health/ai-providers.md): Connect cloud, private-enclave, crypto-paid, custom, local, and remote compatible AI backends, then compare their lab-import accuracy and speed.
- [Import lab PDFs into getbased](https://docs.getbased.health/guides/pdf-import.md): Import lab reports as PDFs, photos, or screenshots, review AI-extracted results, and understand the privacy boundary for text and image modes.
- [Add values manually in getbased](https://docs.getbased.health/guides/manual-entry.md): Type in lab results, body metrics, weight, blood pressure, and resting heart rate by hand — including out-of-range sanity checks and no AI provider needed.
- [Import specialty lab panels into getbased](https://docs.getbased.health/guides/specialty-labs.md): Import OAT, Metabolomix+, fatty acid panels, DEXA scans, and other specialty labs with product-aware marker histories.
- [Read biomarker trend charts in getbased](https://docs.getbased.health/guides/biomarker-charts.md): Understand core and specialty biomarker charts, effective ranges, calculated markers, category placement, overlays, date comparison, and correlations.
- [Understand lab ranges and calculated markers](https://docs.getbased.health/guides/lab-ranges-calculated-markers.md): Learn which range getbased shows, how collection context changes interpretation, and how calculated ratios and biological age avoid duplicate results.
- [Understand trend alerts in getbased](https://docs.getbased.health/guides/trend-alerts.md): How getbased flags sudden biomarker jumps, slow drifts via linear regression, and critical out-of-range values — and where alerts surface across the app.
- [Track lab results getbased does not recognize](https://docs.getbased.health/guides/custom-markers.md): Track any lab result not in the built-in schema — create, edit, and group custom biomarkers manually or let PDF import do it automatically.
- [Import and interpret DNA data with getbased](https://docs.getbased.health/guides/dna-import.md): Import raw DNA, a SNP report, or selected catalog calls and review 60 curated associations without uploading your genome.
- [Track supplements and medications](https://docs.getbased.health/guides/supplements-medications.md): Record current and past therapies, schedules, ingredients, product quality evidence, and dose changes without losing history.
- [Log meals and review nutrition patterns](https://docs.getbased.health/guides/meals-nutrition.md): Log meals from photos, nutrition labels, or manual values; review editable estimates, targets, timing, trends, and model benchmarks without saving full-size photos.
- [Connect wearables and track biometrics](https://docs.getbased.health/guides/wearables.md): Sync supported wearable providers, import Apple Health, enable WHOOP or Google Health when self-hosting, or log readings manually.
- [Track your menstrual cycle in getbased](https://docs.getbased.health/guides/menstrual-cycle.md): Log periods, understand recorded and predicted blood-draw phases, use phase-aware hormone ranges, and read cycle labels on biomarker charts.
- [Log sun exposure sessions in getbased](https://docs.getbased.health/guides/sun-sessions.md): Record sun sessions, model wavelength-related light signals, and keep timing and skin-safety context together.
- [Track your indoor light environment](https://docs.getbased.health/guides/light-environment.md): Record rooms, screens, and practical light observations as heuristic context for your Light & Sun history.
- [Check light, banding, color, and darkness](https://docs.getbased.health/guides/light-tools.md): Use eight local tools for practical, source-aware checks of brightness, camera banding, color appearance, windows, rooms, and solar timing.
- [Log EMF measurements](https://docs.getbased.health/guides/emf-assessment.md): Record room-by-room EMF readings, rate them against building-biology thresholds, and include them in profile context and recommendations.
- [Understand your Biology Scores](https://docs.getbased.health/guides/biology-scores.md): Use Biology Scores, Biological Coherence, context checks, and the Coverage Planner to see which body systems look strong, strained, or under-tested.
- [AI chat for lab result interpretation](https://docs.getbased.health/guides/ai-chat.md): Ask questions about your labs without pasting results manually. getbased sends the AI the relevant profile context when you chat.
- [Use an installed AI agent](https://docs.getbased.health/guides/cli-agents.md): Connect an installed agent through getbased Companion, choose models, and understand local and personal-gateway limits.
- [See what getbased asks AI](https://docs.getbased.health/guides/ai-prompts.md): Find the instruction used by chat, imports, insights, and Light & Sun—and see what information is included with it.
- [Use voice in AI chat](https://docs.getbased.health/guides/voice.md): Dictate chat messages and listen to AI replies with on-device models, a compatible server, an existing AI-provider connection, xAI, or ElevenLabs.
- [Test and compare AI models](https://docs.getbased.health/guides/ai-model-testing.md): Measure lab-import accuracy and speed with a verified sample report or your own imports, then compare local models, hosted models, and cloud providers side by side.
- [Use Recommendations in getbased](https://docs.getbased.health/guides/recommendations.md): Get suggested next steps based on your labs, wearable data, light exposure, genetics, goals, and saved health context.
- [Add health context for better interpretation](https://docs.getbased.health/guides/context-cards.md): Nine context cards capture goals, medical history, daily life, and environmental factors that can help explain your health data.
- [Customize how AI interprets your health data](https://docs.getbased.health/guides/interpretive-lens.md): Tell getbased which medical experts, research traditions, or scientific frameworks you want the AI to consider when interpreting your data.
- [Use your own documents in AI answers](https://docs.getbased.health/guides/knowledge-base.md): Let getbased search your research papers, clinical guides, or notes before the AI answers. Use the in-browser engine or connect an external knowledge server.
- [Connect getbased to external AI assistants](https://docs.getbased.health/guides/agent-access.md): Connect MCP-compatible AI assistants to getbased with a private setup command. The gateway stores only encrypted context; decryption happens locally.
- [Use Routstr Bitcoin payments for AI](https://docs.getbased.health/guides/routstr.md): Use decentralized Bitcoin AI in getbased with a local Cashu wallet, Lightning funding, Routstr node deposits, refunds, token export, and seed restore.
- [Share a profile with a password-protected link](https://docs.getbased.health/guides/profile-sharing.md): Create a temporary locked link for one getbased profile, send the password separately, and stop sharing when you are done.
- [Sync getbased across multiple devices](https://docs.getbased.health/guides/cross-device-sync.md): Use a 24-word mnemonic to sync profiles, labs, reviewed meals, and settings across devices. The relay stores only encrypted data.
- [Encrypt your getbased data at rest](https://docs.getbased.health/guides/encryption.md): Add a passphrase to protect your health data with AES-256-GCM encryption at rest, independently of sync.
- [Back up and restore your getbased data](https://docs.getbased.health/guides/backup.md): getbased protects your health data with three independent backup layers — automatic snapshots, daily folder backups, and manual JSON exports.
- [Export and import your data in getbased](https://docs.getbased.health/guides/export-import.md): Download your health data as JSON or PDF, import it on any device, and migrate between profiles — no AI provider needed for any import.
- [Self-host getbased](https://docs.getbased.health/guides/self-hosting.md): Technical guide for running your own getbased instance, wearable OAuth apps, sync relay, and local AI.
- [Developer documentation](https://docs.getbased.health/developers.md): Developer guide index for getbased: architecture, data model, AI surfaces, feature internals, testing, deployment, and release gates.
- [Architecture](https://docs.getbased.health/developers/architecture.md): How the native-module getbased app is structured, started, tested, and layered.
- [Module reference](https://docs.getbased.health/developers/module-reference.md): Reference map for the getbased native ES modules and compatibility exports.
- [Cross-module patterns](https://docs.getbased.health/developers/cross-module-patterns.md): Window exports, circular dependency avoidance, and shared state patterns in getbased.
- [Marker model and category placement](https://docs.getbased.health/developers/marker-model.md): Stable marker identity, generated schema authoring, visual category placement, persistence compatibility, and contributor checks.
- [Laboratory terminology registry](https://docs.getbased.health/developers/marker-terminology.md): How getbased models LOINC, NPU, NČLP, and UCUM mappings without coupling external codes to marker identity or profile storage.
- [Data pipeline](https://docs.getbased.health/developers/data-pipeline.md): How getbased turns stored profile data into active chart, scoring, and AI data.
- [Lab markers and range internals](https://docs.getbased.health/developers/lab-markers-ranges-internals.md): Marker identity, effective-range precedence, import-owned collection context, calculated markers, migrations, and focused test ownership.
- [Report data contract](https://docs.getbased.health/developers/report-data.md): Versioned, renderer-independent report snapshots shared by PDF rendering, practitioner summaries, and authorized local integrations.
- [Storage schema](https://docs.getbased.health/developers/storage-schema.md): Local-first storage keys, importedData shape, IndexedDB use, and sync-relevant state.
- [Sync and delta internals](https://docs.getbased.health/developers/sync-delta-internals.md): How getbased adds profile surfaces to encrypted cross-device sync without breaking local edits, tombstones, or import provenance.
- [Context assembly](https://docs.getbased.health/developers/context-assembly.md): How getbased assembles lab, profile, nutrition, wearable, lens, and UI context for AI prompts.
- [AI surfaces map](https://docs.getbased.health/developers/ai-surfaces-map.md): Where getbased uses AI versus deterministic code.
- [AI provider internals](https://docs.getbased.health/developers/ai-provider-internals.md): Developer contract for direct provider routing, cloud consent, private transports, Local AI adapters and lifecycle, model storage, OAuth, and web-search boundaries.
- [CLI agent provider internals](https://docs.getbased.health/developers/cli-agent-providers.md): Companion transports, adapter capabilities, profile-scoped tools, gateway boundaries, lifecycle authorization, and verification.
- [AI model testing internals](https://docs.getbased.health/developers/ai-model-testing-internals.md): Developer contract for import benchmark capture, reference scoring, comparison identity, local-only persistence, and fixture maintenance.
- [Agent Access relay](https://docs.getbased.health/developers/agent-access-relay.md): Developer contract for owner-bound Agent Access writes, encrypted context envelopes, token mapping, and MCP decryption.
- [Local Lens internals](https://docs.getbased.health/developers/lens-local-internals.md): How the in-browser getbased Knowledge Base stores libraries, chunks documents, embeds passages, and differs from the external Lens endpoint contract.
- [Lens endpoint contract](https://docs.getbased.health/developers/lens-endpoint-contract.md): Wire spec for external Knowledge Base / Lens servers.
- [System prompt catalog](https://docs.getbased.health/developers/system-prompts.md): Public inventory, ownership, trust boundaries, and review workflow for every developer-controlled AI instruction family.
- [Chat and retrieval prompts](https://docs.getbased.health/developers/system-prompts-chat.md): Exact and parameterized prompts for chat, personalities, discussion, continuation, summaries, and Knowledge Base query rewriting.
- [Import and extraction prompts](https://docs.getbased.health/developers/system-prompts-imports.md): Prompt contracts for lab reports, local PII rewriting, supplements, EMF reports, and light-device specification extraction.
- [Insight and report prompts](https://docs.getbased.health/developers/system-prompts-insights.md): Prompts for reports, dashboard insights, profile summaries, Biology Scores, supplements, markers, and EMF interpretation.
- [Nutrition prompts](https://docs.getbased.health/developers/system-prompts-nutrition.md): Meal-photo, nutrition-label, correction, benchmark, and selected-history AI instructions with their schemas, context, and privacy boundaries.
- [Light and Sun prompts](https://docs.getbased.health/developers/system-prompts-light.md): Shared guardrails and all Light & Sun AI verdict prompts for measurements, rooms, screens, devices, sessions, patterns, and onboarding.
- [Biology Scores internals](https://docs.getbased.health/developers/biology-scores.md): Implementation guide for Biology Scores, Biological Coherence, context checks, adapters, sync, and tests.
- [Chat internals](https://docs.getbased.health/developers/chat-internals.md): Developer contract for chat drafts, thread storage, bounded rendering, message edits and forks, discussion rounds, custom personas, sync, and backups.
- [Genome evidence methodology](https://docs.getbased.health/developers/genome-evidence-methodology.md): How the public SNP catalog separates association direction, evidence strength, personal relevance, and claim scope.
- [Supplements and medications internals](https://docs.getbased.health/developers/supplements-medications-internals.md): Lifecycle modeling, reviewed imports, quality evidence, AI context, migration, and sync contracts for therapy records.
- [Meals and Nutrition internals](https://docs.getbased.health/developers/nutrition-internals.md): Developer contract for meal analysis, editable nutrient data, encrypted thumbnail-only storage, history aggregates, benchmarks, targets, sync, and AI context.
- [Sun spectrum model](https://docs.getbased.health/developers/sun-spectrum-model.md): Bird-Riordan spectral reconstruction and Light session modeling.
- [Wearables internals](https://docs.getbased.health/developers/wearables-internals.md): Developer contract for wearable OAuth routing, hosted consent, device-local credential encryption, daily rows, summaries, and Agent Access.
- [TEE attestation and encrypted AI transport](https://docs.getbased.health/developers/tee-attestation.md): How getbased verifies Tinfoil enclaves, how Venice's separate encrypted protocol differs, and what each transport does and does not establish.
- [Testing](https://docs.getbased.health/developers/testing.md): How to run and write getbased tests across Node, Vitest, and Playwright.
- [Deployment](https://docs.getbased.health/developers/deployment.md): Production build, hosted service boundaries, self-host variables, service worker, CSP, and PWA configuration.
- [Legal consent and release gates](https://docs.getbased.health/developers/legal-consent.md): How getbased gates first launch and legal re-consent before tours, changelogs, analytics notices, and other startup overlays.
- [Routstr/Cashu safety](https://docs.getbased.health/developers/routstr-cashu-safety.md): Developer invariants and required test layers for getbased Routstr/Cashu wallet, node deposit, refund, token export, seed restore, and Cashu TS migration work.
- [Codex PR coverage workflow](https://docs.getbased.health/developers/codex-pr-coverage-workflow.md): Contributor workflow for PR coverage checks and Codex-assisted work.

## Optional

- [GitHub](https://github.com/elkimek/get-based)
- [Discord](https://discord.gg/zJdVB9zgQB)