getbased is a free, open-source health dashboard that turns lab PDFs into interactive charts and AI-powered health insights. Track 287+ biomarkers over time, detect trends, and get personalized interpretations — all stored locally in your browser with no account required.
Live app · Documentation · Discord
- AI-powered PDF import — drop any lab report (any format, language, or country) and AI extracts and maps results to 287+ known biomarkers automatically. Batch import, direct image import (JPG/PNG/WebP), auto image mode for scanned PDFs
- Biomarker trend charts — interactive line charts with proportional time scale, reference bands, optimal ranges, and trend detection across 16 categories
- AI chat — ask questions about your results with full health context, image attachments, multiple personalities, conversation threads
- DNA import — upload raw data from AncestryDNA, 23andMe, MyHeritage, FTDNA, or Living DNA. 42 curated SNPs across 10 categories (methylation, iron, lipids, vitamin D, etc.) with APOE haplotype resolution. Genetic factors shown on dashboard, detail modals, and in AI context
- Specialty lab adapters — OAT (165 markers), fatty acids (Spadia, ZinZino, OmegaQuant), Metabolomix+. Any other specialty test imports through the custom marker pipeline
- Biological age — PhenoAge (Levine 2018) + Bortz Age (Bortz 2023) combined into a unified Biological Age marker with component breakdown
- Calculated markers — HOMA-IR, BUN/Creatinine ratio, free water deficit, lipid ratios (TG/HDL, LDL/HDL, ApoB/ApoA-I), NLR, PLR, De Ritis ratio, hs-CRP/HDL cardiovascular risk ratio
- Trend alerts — sudden changes and linear regression flagged on the dashboard
- Correlation viewer — compare any two markers, heatmap view
- Compare dates — side-by-side comparison of any two lab dates
- Manual entry — add results without a PDF, create custom biomarkers
- Marker glossary — searchable reference for all markers with values and ranges
- Interpretive lens — frame AI analysis through specific scientific paradigms or experts
- 9 lifestyle context cards — diet & digestion, sleep, exercise, stress, light & circadian, environment, EMF assessment (Baubiologie SBM-2015), and more — each gets an AI health rating and enriches all interpretations
- Menstrual cycle tracking — phase-aware reference ranges, cycle phase bands on charts, perimenopause detection, symptom tracking
- Supplement & medication timeline — overlaid on charts to correlate with biomarker changes
- PDF reports — export a full health report as PDF
- Multi-profile — track multiple people, client list with search/sort/filter
- All data stored locally in your browser (localStorage + IndexedDB) — nothing on a server
- Personal info stripped from PDFs before AI processing (regex + streaming local AI obfuscation)
- AES-256-GCM encryption at rest
- Automatic backups (IndexedDB snapshots + daily folder backup via File System Access API)
- Venice AI end-to-end encryption option — prompts encrypted client-side (ECDH secp256k1 + AES-256-GCM), decrypted only inside a TEE. Nothing readable in transit or at rest on their servers
- Run a local AI server and nothing leaves your machine at all
- No account, no sign-up, no tracking
| Provider | Description |
|---|---|
| OpenRouter | Model marketplace — one key, 200+ models (Claude, GPT, Gemini, Grok, DeepSeek). One-click OAuth connect. Recommended for most users. |
| Anthropic | Direct Claude API. Best accuracy on medical data. |
| Venice AI | Privacy cloud with optional end-to-end encryption — prompts encrypted client-side, decrypted only in a TEE. |
| Local AI | Any OpenAI-compatible server — Ollama, LM Studio, Jan, llama.cpp. Fully offline. Free forever. |
Switch providers anytime. All non-AI features work without a provider configured.
| getbased | Typical blood test apps | |
|---|---|---|
| Open source | GPL-3.0 | Closed source |
| Cost | Free | Free tier + paid upsell |
| Data storage | Local browser, encrypted | Cloud (their servers) |
| AI providers | 4 choices (including fully local) | Locked to one |
| Lab import | Any PDF, any format, any language | Specific labs/formats only |
| Biomarkers | 287+ standard + unlimited custom | Limited set |
| Specialty labs | OAT, fatty acids + custom marker pipeline for any test | Blood only |
| DNA raw data | 42 curated SNPs, APOE, 5 providers | No |
| Lifestyle context | 9 cards inform all AI analysis | None or basic |
| Account required | No | Yes |
git clone https://github.com/elkimek/get-based
cd get-based
node dev-server.jsOpen http://localhost:8000. You need an AI provider API key or local AI server for PDF import and chat. All other features work without one.
No build tools, no bundler, no package manager. Pure ES modules — 36 files under js/.
- Chart.js for interactive charts
- pdf.js for PDF text extraction
- All dependencies vendored locally (
vendor/) — no CDN calls - Installable as a PWA (works offline for non-AI features)
29 browser-based test files run headlessly:
./run-tests.shStarts a local server, runs all tests via Puppeteer, exits 0/1.
See CONTRIBUTING.md. Project board: planned features.
GPL-3.0. See LICENSE.