dosewise-home 0.1.0

Local-first household medication schedule and refill planner

Dosewise Home

Dosewise Home is a local-first household medication schedule and refill planner. Paste a simple medication cabinet CSV, then get a same-week refill queue, daily dose timeline, and pharmacist conversation prompts without creating an account or uploading private health notes.

Features

• Runs locally from a small Python server and browser interface.
• Imports comma, tab, semicolon, or pipe-delimited medication rows.
• Estimates days left and prioritizes critical, soon, scheduled, and steady refills.
• Builds a daily dose timeline from common instruction words like morning, dinner, bedtime, and night.
• Flags plain-language review prompts for common household issues such as grapefruit cautions, duplicate acetaminophen, blood thinner review, and stacked sleep aids.
• Copies a concise refill brief for a caregiver, pharmacy call, or household planning note.

Dosewise Home organizes information only. It does not diagnose, prescribe, or replace medical advice from a clinician or pharmacist.

Installation

Python 3.10 or newer is required.

git clone https://github.com/iwaheedsattar/dosewise-home.git
cd dosewise-home
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .

Usage

Start the local app:

dosewise-home

Open http://127.0.0.1:8765, paste medication rows, and select Build plan.

Example CSV:

name,owner,strength,instructions,quantity_left,doses_per_day,refill_date,notes
Atorvastatin,Sam,20mg,Take one tablet with dinner,12,1,2026-07-03,Avoid grapefruit
Lisinopril,Sam,10mg,Take every morning,24,1,2026-07-20,Blood pressure
Acetaminophen Cold,Lee,500mg,Take at bedtime if needed,4,2,2026-06-30,Cold medicine

A fuller sample is available at examples/household-medications.csv.

CSV Columns

Required columns:

• name
• owner
• strength
• instructions
• quantity_left
• doses_per_day

Optional columns:

• refill_date in YYYY-MM-DD, MM/DD/YYYY, or MM/DD/YY format
• notes

Development

Run tests:

python3 -m pytest

Run without installing:

python3 -m dosewise_home.server

Roadmap

• Add printable weekly pill-box sheets.
• Add encrypted local browser storage for recurring household lists.
• Add optional OCR import from prescription labels.
• Add iCalendar reminders for refill windows.
• Package as a signed desktop application.