Installation

pip install minerva-sdk

The base install pulls in only httpx and pydantic. Everything else is an opt-in extra so the wheel stays small.

Extras

Extra	Adds	Why
`pandas`	`pandas`	`result.to_df()` returns a DataFrame
`table`	`tabulate`	`result.to_table()` for pretty terminal output
`gsheet`	`gspread`, `google-auth`	`mc.io.*_from_sheet` / `to_sheet` for Google Sheets
`excel`	`openpyxl`	`mc.io.*_from_excel` / `to_excel` for `.xlsx`
`storage`	`boto3`	`mc.storage.*` for bulk upload / download
`all`	everything above	One-shot

pip install "minerva-sdk[pandas]"
pip install "minerva-sdk[table]"
pip install "minerva-sdk[gsheet]"
pip install "minerva-sdk[excel]"
pip install "minerva-sdk[storage]"
pip install "minerva-sdk[all]"

Use quotes around minerva-sdk[extra] — zsh interprets [ ] as a glob without them.

Python versions

Required: 3.11+
Tested: 3.11, 3.12, 3.13, 3.14

The SDK is fully type-annotated (ships py.typed). Run mypy / pyright against your code and you’ll get static checking on method args + response shapes for free.

Verify the install

python -m minerva --version
# → minerva-sdk 0.0.x

python -m minerva
# Prints the banner + a usage cheat-sheet.

From Python:

>>> import minerva
>>> minerva.__version__
'0.0.x'
>>> from minerva import Minerva
>>> help(Minerva)        # class + method docstrings

Minerva Python SDK Quickstart

⌘I

Getting started

Endpoints

Power features

Reference

Extras

Python versions

Verify the install

​Extras

​Python versions

​Verify the install

Extras

Python versions

Verify the install