CLI

The BiomAPI CLI is a zero-dependency Python script that calls the REST API and formats results for the terminal. It also works as an Agent Skill through Claude Code and Codex plugin marketplaces, letting AI assistants process biometry reports directly in conversation.

See Supported Devices for the list of biometers BiomAPI can extract from.

Installation

Standalone

Download biomapi-cli.zip, unzip it, and run biomapi.py directly — no pip, no dependencies, pure Python 3.11+:

python biomapi.py status
python biomapi.py process report.pdf

Claude Code plugin

/plugin marketplace add mglraimundo/biomapi-cli
/plugin install biomapi-cli@mglraimundo-biomapi-cli

Codex

codex plugin marketplace add mglraimundo/biomapi-cli

Then install and enable BiomAPI CLI from the Codex plugin directory.

Source repo: mglraimundo/biomapi-cli

Configuration

Interactive setup (saves to ~/.config/biomapi/config):

python biomapi.py configure

Or set directly:

python biomapi.py configure --key biom_your_key_here
python biomapi.py configure --gemini-key AIza_your_key
python biomapi.py configure --show

Priority: CLI flags > environment variables (BIOMAPI_KEY, GEMINI_API_KEY, ESCRS_IOL_CALCULATOR_URL) > config file.

Commands

`process`

python biomapi.py process report.pdf
python biomapi.py process *.pdf         # Multiple files (concurrent)
python biomapi.py process report.pdf --no-pin

Output includes patient name (as acronym), BiomPIN, BiomAPI URL, and ESCRS IOL Calculator link. When patient identifiers are available, both URLs include a browser-only #biomctx=... fragment so name/ID can be restored in a new browser session without being sent to the server.

`retrieve`

python biomapi.py retrieve lunar-rocket-731904

You may also pass a full BiomAPI or ESCRS URL containing #biomctx=... to restore browser-local patient identifiers during retrieval.

`csv`

Generate a by-eye CSV from one or more BiomPINs:

python biomapi.py csv lunar-rocket-731904 solar-river-482910 > export.csv

`usage`

python biomapi.py usage
python biomapi.py usage --validate   # Also verifies your Gemini key

`status`

python biomapi.py status

Prints lightweight API status and deployment metadata, including db_id. For active Gemini/database health checks, call GET /api/v1/health directly.

`configure`

python biomapi.py configure --key biom_...
python biomapi.py configure --gemini-key AIza_...
python biomapi.py configure --show

Access tiers

`BIOMAPI_KEY`	`GEMINI_API_KEY`	`process` limit	`retrieve` limit
—	—	15/day per IP	1,000/day per IP
✓	—	Custom quota	Custom quota
—	✓	`biomai_byok` bucket (your Gemini quota)	1,000/day per IP
✓	✓	`biomai_byok` bucket (your Gemini quota)	Custom quota