pro-ledin-healthos 0.5.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-api engine

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

Configure

Set the AGENT_HEALTH_* environment variables (see 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-api
# vision-api 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.

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