Skip to content

AI Chat

The AI Chat panel lets you have a conversation about your lab results with an AI that already knows everything about your data — your biomarker history, lifestyle context, supplements, notes, and health goals.

Opening the Chat

Click the chat bubble in the bottom-right corner of the screen to slide the chat panel open. You can also click the Ask AI button in the header. Press Escape to close it.

Chat FAB

The floating chat bubble (FAB) is always visible in the bottom-right corner, giving you one-tap access to the AI from any screen.

Setup Guide

If no AI provider is configured, the chat panel shows a setup guide instead of the conversation view. The guide explains your provider options and includes a Connect with OpenRouter button for one-click OAuth setup — no API key needed. Once connected, the chat is ready immediately.

What the AI Knows

Every message you send includes a full snapshot of your data:

  • All lab values across every draw date, with reference ranges and trend direction
  • Your nine Context Cards (diet, sleep, exercise, environment, etc.)
  • Your Interpretive Lens and Health Goals
  • Your supplements and their date ranges
  • A timestamped change timeline for context cards (diet changes, stress level shifts, etc.) so the AI can correlate lifestyle changes with lab trends
  • Your notes
  • For female profiles: menstrual cycle data and phase context

You do not need to paste your results into the chat. Just ask your question.

Active Model Display

The chat header shows the name of your currently active AI model, so you always know which model is responding. Each message also includes a cost footnote showing the estimated token cost for that exchange.

Personalities

The AI adopts a personality that shapes its communication style. Choose from three:

Default

A clear, evidence-informed tone. Explains markers plainly, notes trends, and flags concerns without drama.

House

Takes on the style of a sharp, skeptical clinician who asks uncomfortable questions. Pushes back on assumptions and digs for root causes.

Custom

Create your own persona. Type a name in the custom personality field and click Generate — the AI will create a full personality profile for that persona, including communication style, analytical approach, and philosophical lens. You can edit the generated text before saving.

The Enforce evidence-based accuracy option (off by default) adds a strict disclaimer to the AI's instructions, keeping responses grounded in published research rather than speculation.

TIP

Custom personalities are saved per profile and persist across sessions. You can create a persona based on a specific medical philosophy, a fictional doctor character, or any style that makes conversations more useful for you.

Conversation Threads

The chat panel includes a thread rail on the left side — a list of your past conversations. Each thread is named automatically from your first message, and you can rename any thread by clicking its name.

  • Start a new conversation at any time
  • Switch between threads without losing history
  • Up to 50 threads are stored per profile; the oldest are pruned automatically

On mobile, tap the hamburger icon in the chat header to open the thread list, and use the back button to return to the conversation.

Image Attachments

You can attach images to chat messages — photos of lab reports, supplement labels, food logs, skin conditions, or anything else you want the AI to see.

How to attach:

  • Click the paperclip button in the chat input area
  • Paste an image from your clipboard (Ctrl+V / Cmd+V)
  • Drag and drop an image file onto the chat input

Up to 5 images per message. Supported formats: JPEG, PNG, GIF, WebP.

HD Mode

The HD button next to the paperclip toggles between standard (1024px) and high-resolution (2048px) image quality. HD mode preserves more detail but uses more tokens. Standard mode is usually sufficient for lab reports and supplement labels; use HD for fine print or detailed photos.

Quality Warnings

Before sending, getbased analyzes each image and warns you if it detects issues:

  • Blurry — try holding steady or tapping to focus
  • Too dark — try better lighting
  • Overexposed — try less direct light
  • Low resolution — the AI may struggle with fine details

These checks save tokens by catching bad photos before they're sent.

Privacy

All image metadata is automatically stripped before sending. EXIF data — GPS location, camera model, timestamps, device serial numbers — is removed during the resize step. Only raw pixel data reaches your AI provider.

TIP

The attach and HD buttons only appear when your active model supports vision (image input). If you don't see them, switch to a vision-capable model in Settings.

The Web toggle in the chat header lets the AI search the internet before responding. This is useful for questions about recent studies, drug interactions, supplement research, or anything where up-to-date information matters.

Toggle it on, ask your question, and the AI will pull in current web results alongside your lab context.

Higher cost

Web search injects search results into the AI's context, significantly increasing input tokens. Expect messages to cost 2–4x more than normal. The cost footnote shows a 🌐 web indicator when search was active.

Availability

Web search is available with OpenRouter and Venice only. The toggle is hidden when using Anthropic or Local AI.

Per-Marker AI Explanations

From any marker's detail view (click a marker name in the sidebar or on the dashboard), you will find an Ask AI button. This opens a pre-populated chat asking the AI to explain that specific marker in the context of your results — without you having to type anything.

Markdown Responses

The AI's responses are rendered with full markdown formatting:

  • Headings, bold, and italic text
  • Bullet and numbered lists
  • Code blocks and inline code
  • Clickable links

Responses stream in smoothly as the AI generates them, with a typewriter effect that trickles text at a steady rate for a pleasant reading experience.

Token Costs and What to Expect

Every chat message sends your full lab context + conversation history to the AI. Here's what makes up the token count:

ComponentTypical sizeNotes
System prompt~1,300 tokensFixed — personality instructions, rules
Lab context2,000–15,000 tokensScales with number of draw dates, markers, and filled context cards
Conversation history0–10,000+ tokensLast 30 messages (both yours and AI responses)
Image (current message only)1,000–5,000 tokens per imageOnly attached to the message being sent, not stored in history
Total input per message~3,000–25,000+ tokens

What drives the cost up

  • More draw dates — each date adds values to every marker. 2 dates ≈ 3k lab context; 8+ dates ≈ 10k+
  • Filled context cards — each of the 9 lifestyle cards adds 50–300 tokens when filled
  • Long conversations — AI responses are often 300–800 tokens each. After 10 back-and-forth exchanges, history alone can be 5k–8k tokens
  • Images — a single standard-quality image adds ~1,500–3,000 input tokens. HD images cost more. Images are only sent with the current message, never re-sent in history
  • Web search — when the Web toggle is on, search results are injected into the context, adding thousands of tokens. Expect 2–4x the normal cost per message

Realistic cost examples

Using Claude Sonnet 4 via OpenRouter (~$3/$15 per 1M input/output tokens):

ScenarioInput tokensOutput tokensCost per message
First message, 2 draw dates, no images~4,000~500~$0.02
Mid-conversation (10 messages), 4 draw dates, all cards filled~15,000~600~$0.05
Long conversation (20+ messages), 8 draw dates, 1 image~25,000~800~$0.09
Discuss mode (2 personas, 3 rounds each)~20,000 × 6~600 × 6~$0.40 total

Cost-saving tips

  • Start new threads — click "New Chat" to reset conversation history to zero. This is the single biggest cost saver
  • Use standard image mode (not HD) unless you need fine detail
  • Local AI is free — run Ollama or LM Studio locally for unlimited chat at zero cost
  • Venice offers free-tier models with no per-token charges

Each message shows its cost

Every AI response includes a footnote showing the model name, estimated cost, and total token count — so you always know exactly what you're spending.

Choosing a Provider

The AI chat works with any of the four supported providers: Anthropic, OpenRouter, Venice, or Local AI. See AI Providers to configure your key or local server. The chat is not available until a provider is set up.

WARNING

Conversations are stored locally in your browser and encrypted if you have set a passphrase. The last 30 messages from each conversation are sent to the AI provider with every request to maintain context. Your provider's privacy policy applies to that data.

Released under the GPL-3.0 License.