future-healthcare 0.0.3

Python library and optional CLI for Future Healthcare

future-healthcare-cli

Python library and optional CLI for Future Healthcare.

The CLI helps with common refund flows:

• login stores your API token locally
• check lists refund status/history
• submit submits a new expense with receipt metadata

Install

Install the CLI with uv:

uv tool install 'future-healthcare[cli]'

This makes the future-healthcare command available on your system.

If you want receipt parsing via OCR / vision models as well:

uv tool install 'future-healthcare[cli,vision]'

Run Without Installing

You can also run it directly with uvx:

uvx --from 'future-healthcare[cli]' future-healthcare --help

With vision support:

uvx --from 'future-healthcare[cli,vision]' future-healthcare submit --help

Usage

Log in first:

future-healthcare login -u YOUR_USERNAME -p YOUR_PASSWORD

Check existing refunds:

future-healthcare check

Submit a receipt by passing the required fields explicitly:

future-healthcare submit ~/Downloads/example-receipt.pdf \
  --business-nif 509876543 \
  --invoice-number 'INV 2026/0001' \
  --total-amount 40 \
  --date '2026-03-14'

Or let the CLI extract those fields from the receipt with vision support:

future-healthcare submit ~/Downloads/example-receipt.pdf --vision

The submit command may prompt you to choose the insured person, service, or building when multiple matches are available.

Local Data

The CLI stores local state under the platform-specific config directory for future-healthcare-cli, including:

• token.txt for the login token
• config.toml for CLI defaults
• logs/ for submission logs and copied input files

Development

See CONTRIBUTING.md.