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 for Claude Code and Codex CLI, letting AI assistants process biometry reports directly in conversation.

Supported devices

Device	Manufacturer	PK Support
Aladdin	Topcon	—
Anterion	Heidelberg	Yes
Argos	Alcon	—
EyeStar ES900	Haag-Streit	Yes
IOLMaster 700	Zeiss	Yes
Lenstar LS 900	Haag-Streit	—
MS-39	CSO	Yes
OA-2000	Tomey	—
Pentacam AXL	Oculus	Yes

PK Support = posterior keratometry extraction for toric IOL formulas.

Installation

Standalone

Download biomapi.py — 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 CLI

cp -r skills/biomapi ~/.codex/skills/

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

`retrieve`

python biomapi.py retrieve lunar-rocket-731904

`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

`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
—	—	30/day per IP	1,000/day per IP
✓	—	Custom quota	Custom quota
—	✓	Unlimited (your Gemini quota)	1,000/day per IP
✓	✓	Unlimited (your Gemini quota)	Custom quota