Skip to content

Quickstart

You don't need an API key, an account, or network access to try care-voice.

Install

python3 -m pip install care-voice

You need Python 3.11 or later.

Run a check-in

Start an interactive check-in and answer the questions yourself:

care-voice simulate --name Margaret --db demo.db

Press Enter on an empty line to stay silent, or Ctrl-D to hang up. To replay a file of replies instead, save them one per line:

cat > concerning-day.txt <<'EOF'
# A day that should raise several alerts. Run it with --date 2026-09-30,
# which is a Wednesday.
Not really, I kept waking up
No, I forgot them
Not yet
Yes, my hip hurts
About an eight
My right hip
I slipped in the bathroom last night
Is it Sunday?
Pretty low today
EOF
care-voice simulate --name Margaret --replies concerning-day.txt --date 2026-09-30 --db demo.db

The summary at the end lists each answer and each alert, with the replies that triggered it:

alerts:
  [HIGH] FALL_REPORTED: Margaret reported a fall.
      - answered yes to the fall question: "I slipped in the bathroom last night"
  [HIGH] MISSED_MEDS: Margaret has not taken their morning medication.
      - said: "No, I forgot them"

Look at the history

care-voice history --db demo.db
care-voice alerts --db demo.db

Open the dashboard

care-voice serve --db demo.db

Then open http://127.0.0.1:8080/.

Next steps