Skip to content

v0.1.0

Choose a tag to compare

View all tags
@100yenadmin 100yenadmin released this 08 Nov 08:46
· 50 commits to main since this release
v0.1.0
b245d3c

Caduceus: Personalized Health & DNA AI is your Hermes agent's private health memory. This is its first release.

It keeps these in one SQLite vault on your own machine:

  • your 23andMe or AncestryDNA raw data;
  • your Promethease report;
  • your Apple Health export;
  • your US health records.

Your agent can then answer questions like "Why isn't my Ozempic working?" from your genotype, your trends and published research. Every answer is cited and states its limits.

The rebuilt variant report

What's in v0.1.0

  • Imports:

    • DNA raw data: 23andMe v3, v4 and v5, and AncestryDNA.
    • Promethease reports, decoded without running their scripts.
    • Apple Health exports.
    • FHIR R4 health records, read from the Apple Health export or from standalone JSON.

    Each file is stored once. Imports are resumable, and a re-import changes nothing.

  • Four tools:

    • caduceus_search: cited full-text search.
    • caduceus_genome: lookups, gene views, gene–drug checks (CPIC guidelines plus GLP-1 research), and APOE and CYP2C19 calls.
    • caduceus_trend: trends, and before/after comparisons around a medication start.
    • caduceus_capture: imports, confirmed medication records, notes, settings, the research watch and the health brief.

  • Two local pages:

    • your variant report, rebuilt offline as a self-contained page;
    • a one-page health brief with charts, to bring to your doctor.

  • Privacy levels, chosen with /caduceus:

    • open, the default;
    • standard, which hides Alzheimer's risk, hereditary cancer risk, carrier status, mental health and reproductive results until you unlock each one.

    Hidden results are counted, never described.

  • Research watch: Europe PMC, LitVar2 and ClinVar. The first run gives a top-3 digest; after that you see only new items. It sends gene, drug and topic terms, never genotypes.

  • Blueprints: research-watch and daily-check.

  • Skills: setup, guide, research and report-a-problem.

Install

Requires Hermes Agent 0.23.0 or newer. There are no extra dependencies.

hermes plugins install https://github.com/electricsheephq/caduceus

Restart Hermes, then tell your agent "set up Caduceus".

Disclosure

Imports, search and reports run locally, and the vault is never uploaded as a whole. Tool results (slices of your data) enter the conversation, so the model provider you chose sees them. A research watch you turn on sends gene, drug and topic terms, never genotypes, to Europe PMC and NCBI. Scheduled checks run model turns billed like any message. There is no telemetry.

Caduceus includes a report-a-problem skill. The agent drafts a bug report, asks you to check it holds no health data, and files it to this repository with gh only after you approve the draft.

Limits

  • Consumer chips miss rare variants and can miscall them. Anything important needs a clinical test.
  • Some genes can't be read from a chip. CYP2D6, HLA types and copy-number changes are reported as not assessed.
  • Genetic effects on drug response are usually small. Every result carries its evidence level, sources and limits.
  • The vault is not encrypted at rest in v0.1. Encrypted and local-model levels are planned for v0.4.
  • Known follow-ups:
    • #1: a research-watch failure late in a run loses its receipt.
    • #2: the first digest can rank broad pharmacogenomics papers above gene-specific ones.
    • Record-matching limits are listed in docs/contracts.md.

Information with limits, not medical advice. Caduceus never tells you to start, stop or change a medication. Talk to your prescriber.

Assets 2
Loading