Caduceus 0.2.1

Fixed

• The brief's weight and lean mass panels now compare around the start of your GLP-1 medicine when one is recorded, so they match the chat. Before, a later start of any other medicine moved them. (#9)
• /caduceus erase confirm now also refuses while a Caduceus request is still running in another chat (a brief, a report, a record being saved); run it again when that finishes. Requests that arrive during an erase wait until it finishes. Research results kept in memory are cleared every time. (#10)
• Vaults whose Apple Health export was imported before 0.2.0 now get lean mass, protein and waist from the samples already stored. Caduceus rebuilds its daily summaries once, in the background, the first time you ask about a trend, so no new export is needed. (#11)

Install: hermes plugins install electricsheephq/caduceus --enable

Not medical advice.

Caduceus 0.2.0

Added

• /caduceus erase. It lists what Caduceus stored on this machine. /caduceus erase confirm deletes the vault, the samples, the copied files, the reports and the demo files, and nothing else. It refuses while an import, the demo or a research watch is running in the same Hermes process. Settings stay. Only the user can run it; no tool erases.
• GLP-1 companion metrics. lean_mass, protein (grams a day, one source a day) and waist from Apple Health work in every trend operation, including before-and-after comparisons around a medication start. Pounds, inches and milligrams are converted. The health brief adds lean mass and protein panels.
• The demo persona has a smart scale's lean mass, a food log's protein and waist entries, so "Am I losing muscle on Ozempic?" has an answer. Earlier demo numbers are unchanged. In a vault that already holds the old demo, run /caduceus erase confirm and then /caduceus demo to see them.
• The guide skill covers muscle and protein questions: numbers and dates, no diet or exercise prescriptions.

Notes

• Existing vaults get the new metrics when you import a new Apple Health export.

Install: hermes plugins install electricsheephq/caduceus --enable

Not medical advice.

Caduceus 0.1.5

Docs

• The launch video plays in the README. It sits right under the "Watch the demo on X" link.

Docs only: no code changes from 0.1.4.

Caduceus 0.1.4

Docs

• The README links to the launch video. "Watch the demo on X" sits right under the opening sentence.

Docs only: no code changes from 0.1.3.

Caduceus 0.1.3

Added

• A reminder for every model, so smaller ones answer from your vault. Some smaller models answered "Why isn't my Ozempic working?" from general knowledge, without calling any Caduceus tool, so the guidance in the tool results never reached them. Now the first health, medication or DNA question in each chat carries one short fixed note for the model. It says:

  • answer from the caduceus_* tools and cite them;
  • never suggest starting, stopping, switching or changing a medication, its form or its dose, and say to talk to the prescriber.

  The note:

  • fires only on health, medication or DNA wording: drug names from the knowledge pack and from your recorded medications, words like genotype or HbA1c, and everyday words like sleep or weight only in a message with "I", "me" or "my";
  • needs data in your vault;
  • holds none of your data, and never blocks a message.

  The new vault_hint setting (on by default) turns it off.

Docs

• The README opens with what Caduceus does for you, then gets you to a first result.
  • It installs with hermes plugins install electricsheephq/caduceus --enable.
  • A "Try it" walkthrough runs the demo and shows the cited answer you get.
• New README sections: a comparison with stock Hermes, the settings, where it works, troubleshooting, and how to report a bug.
• CONTRIBUTING.md is new.

The Disclosure now names the vault hint: one fixed note, holding none of your data, on the first health, medication or DNA question of each chat when the vault has data; the vault_hint setting turns it off.

Caduceus 0.1.2

Added

• A gene–drug profile in the DNA summary. With or without a variant report, caduceus_genome op=summary lists:

  • the genes where you carry an effect allele, with the medicines that published guidance covers for them;
  • the derived calls.

  A flag means guidance exists if the medicine is ever prescribed; "no flag" does not mean normal. Your privacy settings apply as everywhere else.

• A check that a vault holds one person. When you import a second DNA file, Caduceus compares it with the earlier ones on shared markers and says plainly whether it looks like the same person. While the vault holds more than one person's DNA, results carry a warning.

• Listing your medications. caduceus_search with kinds=["medication"] and no query lists your recorded medications, newest first.

Changed

• Answers stay careful even when the agent skips the guide skill.
  • Trend comparisons, trends about a medication, and search results that include a medication carry a short instruction for the agent. It says this is information with limits, not medical advice, and never to suggest starting, stopping or changing a medication or its dose; for any medication decision, talk to the prescriber.
  • A comparison around a medication's start points to the gene–drug check for that medicine, and the tool descriptions carry the same rules.
• Trends say where your data ends. Results give your data's full date range and say when the window you asked for stops before it.
• Search results say they are filtered by your words, and how to list everything of one kind. A misspelt kind is an error that names the valid kinds, never an empty list.

Fixed

• Apple Health exports from iPhones set to other languages now import. The export is found by its content, not its file name: Spanish and Brazilian Portuguese phones write exportar.xml, and Norwegian and Danish phones write eksport.xml. An unzipped export XML imports too.
• Gene lookups work without a variant report. op=gene answers from the built-in knowledge pack's markers.
• The demo recovers from a crash between saving its files (#3).
• Unrecognised files: the message now says that whole-genome VCF files are not supported yet.

Caduceus 0.1.1

Added

• /caduceus demo: loads an invented demo person into an empty vault, so you can try Caduceus without your own data. It refuses when the vault already holds your files, so the two never mix.
• More DNA raw data: MyHeritage and FamilyTreeDNA files (.csv, .csv.gz, or zipped). Living DNA files are labelled as Living DNA.

Changed

• The research watch puts your own gene–drug pairs first (#2).
  • The first digest runs one query per current medication (its knowledge-pack genes and markers, with genetic terms, over five years). Papers that mention your markers come next (LitVar2), then general results.
  • Later digests use the same order, and every item says why it was picked.
  • The search terms still depend only on your medications, your topics and the public knowledge pack, never on your genotypes.
• Doses: answers mention a dose only as recorded, and never compare it with other doses.

Fixed

• A research watch run that fails after its call returned is reported once, to the next run, instead of being lost (#1).

v0.1.0

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.

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.