Metadata-Version: 2.4
Name: dosewise-home
Version: 0.1.0
Summary: Local-first household medication schedule and refill planner
Author: Dosewise Home
License-Expression: MIT
Keywords: medication,refill,health,household,planner
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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.

![Dosewise Home dashboard](assets/screenshots/dosewise-home.svg)

## 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.

```bash
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:

```bash
dosewise-home
```

Open [http://127.0.0.1:8765](http://127.0.0.1:8765), paste medication rows, and select **Build plan**.

Example CSV:

```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:

```bash
python3 -m pytest
```

Run without installing:

```bash
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.
