Install the SDK
Hollerith is a private SDK. It is not on PyPI, and Set your API key. Create one on the API Keys page in the console — see Authentication.Both are required.
pip install hollerith will not work.
During the closed beta it ships as a pre-built wheel served from your control plane. Your
console’s Quickstart tab shows the exact current URL.HOLLERITH_BASE_URL has no default — without it the client raises a
ValueError before it ever reaches the API.Confirm the install:Make your first prediction
This example uses the iris sample from the console: 150 rows, 4 columns, one labeled
species column.
fit uploads the table and returns a context to predict against. predict reads it.Download the CSV from the console’s Quickstart tab, or run the same dataset there without
writing any code.A console run uses your signed-in session, never an API key — the browser is never sent one.
It takes the same validation, worker, metering and cleanup path as an SDK job, so it shows up
under Usage and bills the same rows.Measure the accuracy
A prediction is worth little without a number beside it. Pass One metric comes back: accuracy for classification, RMSE for regression. Compare it against
whatever you are running today — Evaluating accuracy covers how
to make that comparison fair.
evaluate=True to fit and
Hollerith scores itself on held-out rows.evaluate=True runs a second job and bills it separately.A score means nothing without a floor to compare it against. On a table where 90% of rows
share one label, 0.90 is what guessing gets you — Evaluating accuracy
covers how to set that floor before you read the number.What just happened
fit did not train anything. It sent your table to a context the model reads while
predicting, closer to handing someone a reference sheet than making them study for the exam.
That is why it takes seconds and why there is nothing to tune.
The context is reusable. Predict against it as many times as you need without fitting again.
Swap in your own table
Two lines change:Your table needs one row per thing you are predicting and one column holding the label.
Categoricals and missing values are read directly, with no encoding and no imputation.Text and date columns are accepted, but read as categories — the model sees which rows share
a value, not what the value means. The columns you predict on must match the columns you fit
on.
Predict a number
Same shape, numeric target. Hollerith reads the task from the target column.task="regression" when that is wrong.
Next steps
- Limits and quotas — how large a table can get, and how long a context lives
- Evaluating accuracy — what
evaluation_reports, and how to compare fairly - Python SDK — every argument
Hollerith()takes - Preparing your table — dtypes, targets, and the traps