> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbased.health/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started with getbased in under ten minutes

> Launch getbased in your browser, take the first-visit tour, connect an AI provider when you need it, and import labs, DNA, wearables, or demo data.

getbased runs entirely in your browser with no installation and no account. A fresh profile starts with a short guided tour, then sends you to guided chat so you can decide what to add first.

<Note>
  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.
</Note>

## Steps

<Steps>
  <Step title="Open the app">
    Go to [app.getbased.health](https://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.

    | 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"                                                        |

    **Self-hosting**

    If you prefer to run getbased yourself, clone the repository and start a local server:

    ```bash theme={null}
    git clone https://github.com/elkimek/get-based
    cd get-based
    node dev-server.js
    ```

    Then open `http://localhost:8000`. A local server is required because the app uses native ES modules.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.

    See [Connect an AI provider](/ai-providers) for a full comparison and setup instructions.
  </Step>

  <Step title="Add data or load a demo">
    **Start with guided chat**

    On 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 directly**

    Use 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 profile**

    If 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

    You can also load demo profiles from the profile switcher in the header.

    **Enter values manually**

    For lab values, open a marker detail view and click **+ Add Value Manually**, fill an empty cell in **Compare dates**, or create a marker from **Custom markers**. For body metrics, use **Body** or the **Biometrics Overview** widget to log weight, blood pressure, or resting heart rate.
  </Step>

  <Step title="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

    See [Use the dashboard](/guides/dashboard) for the widget and layout controls.
  </Step>
</Steps>