pro-ledin-healthos 0.6.0

Recognize a family medical archive into tracked Obsidian Markdown, delegating OCR to pro-ledin-ocr.

pro-ledin-healthos

Recognize an external family medical archive (PDFs, scans, photos) into tracked Obsidian Markdown that mirrors the source folder structure one-to-one. OCR is delegated to the pro-ledin-ocr package, imported as a library. HealthOS never interprets medical content — it only transcribes and mirrors.

• Import name: pro.ledin.healthos
• Console script: healthos
• PyPI: pro-ledin-healthos

Install

pip install pro-ledin-healthos            # pulls in pro-ledin-ocr
pip install "pro-ledin-healthos[vision]"  # + OpenAI-compatible vision engine
pip install "pro-ledin-healthos[easyocr]" # + EasyOCR
pip install "pro-ledin-healthos[paddle]"  # + PaddleOCR

System binaries poppler and tesseract are required for the local OCR path.

Configure

Set the AGENT_HEALTH_* environment variables (see skills/healthos/SKILL.md for the full list):

export AGENT_HEALTH_SOURCE_DIR=/absolute/path/to/source   # ':'-separated for many
export AGENT_HEALTH_TARGET_DIR=/path/to/vault/03-areas/health
export AGENT_HEALTH_CACHE_DIR=~/Library/Caches/healthos
export AGENT_HEALTH_OCR_ENGINE=vision
# vision engine also needs:
export AGENT_HEALTH_VISION_API_URL=http://127.0.0.1:1234/v1
export AGENT_HEALTH_VISION_API_KEY=token
export AGENT_HEALTH_VISION_MODEL=model-name

Never store real credentials in tracked files.

vision sends medical document images to the configured external endpoint. Use it only with explicit user consent and an endpoint whose access, retention, training, and deletion policies are acceptable for protected health information. Leave AGENT_HEALTH_VISION_API_URL unset only when intentionally using OpenAI's default endpoint.

Upgrade from 0.5

Rename AGENT_HEALTH_OCR_ENGINE=vision-api to AGENT_HEALTH_OCR_ENGINE=vision. The old value is rejected.

Run

healthos index            # recognize + mirror into the target
healthos index --check    # verify cache/outputs without writing

By default HealthOS imports the installed pro-ledin-ocr package. Set AGENT_HEALTH_OCR_SCRIPT=/path/to/ocr.py to load an alternative ocr.py-shaped module from a file instead (importlib escape hatch).

Development

Local dev resolves pro-ledin-ocr from a sibling ../ocr checkout via [tool.uv.sources] in pyproject.toml:

uv run --extra dev pytest
uv build

To test against the published pro-ledin-ocr from PyPI instead (as CI does), add --no-sources:

uv run --no-sources --extra dev pytest
uv build --no-sources

License

MIT