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¶
- Write a config file. See Configuration.
- Tune the thresholds. See Alert rules.
- Send alerts to a webhook or email address with notifiers.